@equinor/fusion-framework 8.1.0 → 8.1.1

package/src/mock/index.ts

@@ -1,62 +0,0 @@
-/**
- * Zero-configuration Fusion Framework instances for tests.
- *
- * @remarks
- * Lets an application initialize the real framework — real modules, real
- * configuration pipeline, real lifecycle — while the boundaries that reach
- * outside the process are substituted with deterministic fakes. No credentials,
- * no network access and no configuration are required.
- *
- * This entry point holds **no mock logic**. Each module owns and exports its own
- * test double from its `./mock` entry point; this entry point only composes the
- * built-in set into a ready-to-use instance. An application module follows the
- * same pattern and plugs in identically.
- *
- * This entry point is test-runner agnostic: it contains no dependency on Vitest
- * or any other test framework, so the same helpers work under any runner.
- *
- * Fixture generators with realistic fake data (e.g. `createContextItems`) live
- * on each module's own `/mock/fixtures` entry point instead of here, since they
- * pull in an extra dependency ({@link https://fakerjs.dev/ | faker}) that
- * plain configurator mocking doesn't need.
- *
- * @packageDocumentation
- */
-
-export { mockFramework, type FrameworkMockConfigureFn } from './mock-framework.js';
-export { FrameworkMockConfigurator } from './FrameworkMockConfigurator.js';
-
-// Re-exported so a test can reach the built-in module mocks without importing
-// each module's `./mock` entry point directly. The mocks are owned by their modules.
-export {
-  enableMsalMock,
-  msalMockModule,
-  MsalMockConfigurator,
-  MsalMockClient,
-  createMsalMockClient,
-  createMockToken,
-  type AuthConfigMockFn,
-  type MsalMockUser,
-  type MockTokenClaims,
-} from '@equinor/fusion-framework-module-msal/mock';
-
-export {
-  mockServiceDiscovery,
-  enableServiceDiscoveryMock,
-  serviceDiscoveryMockModule,
-  ServiceDiscoveryMockClient,
-  ServiceDiscoveryMockConfigurator,
-  createMockService,
-  defaultServiceDiscoveryMockServices,
-  type ServiceDiscoveryConfigMockFn,
-  type MockService,
-  type ServiceDiscoveryMockClientOptions,
-} from '@equinor/fusion-framework-module-service-discovery/mock';
-
-export {
-  enableContextMock,
-  contextMockModule,
-  ContextMockConfigurator,
-  type ContextMockConfigFn,
-  type ContextResolverFn,
-} from '@equinor/fusion-framework-module-context/mock';

package/src/mock/mock-framework.ts

@@ -1,72 +0,0 @@
-import type { AnyModule } from '@equinor/fusion-framework-module';
-
-import { init } from '../init.js';
-import type { Fusion } from '../types.js';
-
-import { FrameworkMockConfigurator } from './FrameworkMockConfigurator.js';
-
-/**
- * Configures a mocked framework before it is initialized.
- *
- * @typeParam TModules - Module descriptors beyond the built-in set.
- * @param configurator - The configurator to configure.
- */
-export type FrameworkMockConfigureFn<TModules extends Array<AnyModule> = []> = (
-  configurator: FrameworkMockConfigurator<TModules>,
-) => void | Promise<void>;
-
-/**
- * Starts a Fusion framework instance that needs no credentials and no network.
- *
- * @remarks
- * The real framework is started: the real module set, the real configuration
- * pipeline and the real lifecycle. Only the boundaries that would need
- * credentials or network access are substituted, so a test exercises the wiring
- * an application actually depends on rather than a reimplementation of it.
- *
- * The configurator passed to `configure` is a {@link FrameworkMockConfigurator},
- * which *is* a `FrameworkConfigurator`. Every `enableX` helper therefore accepts
- * it unchanged — including the ones an application team writes for their own
- * modules.
- *
- * Spying on individual calls is left to the test runner. The framework makes the
- * runtime substitutable; `vi.spyOn`, `bun:test` `spyOn` and `t.mock.method` all
- * work against the resulting instance with no framework support.
- *
- * @typeParam TModules - Module descriptors beyond the built-in set. Supply this
- *   when a test registers application modules, so they are typed on the result.
- * @template TModules - Module descriptors beyond the built-in set.
- * @param configure - Callback that configures the framework before it starts.
- * @returns The initialized framework instance.
- *
- * @example Zero configuration
- * ```typescript
- * const fusion = await mockFramework();
- * ```
- *
- * @example Configure the built-in mocks
- * ```typescript
- * const fusion = await mockFramework((configurator) => {
- *   configurator.msal.setAccount({ name: 'Ada Lovelace' });
- *   configurator.serviceDiscovery.setBaseUri('http://localhost:6669');
- * });
- * ```
- *
- * @example Register an application module
- * ```typescript
- * const fusion = await mockFramework<[InvoiceModule]>((configurator) => {
- *   enableInvoicesMock(configurator, { total: 42 });
- * });
- *
- * await fusion.modules.invoices.getInvoice('1');
- * ```
- */
-export async function mockFramework<TModules extends Array<AnyModule> = []>(
-  configure?: FrameworkMockConfigureFn<TModules>,
-): Promise<Fusion<TModules>> {
-  const configurator = new FrameworkMockConfigurator<TModules>();
-  await configure?.(configurator);
-  return await init(configurator);
-}
-
-export default mockFramework;

package/src/types.ts

@@ -1,82 +0,0 @@
-import type { CombinedModules, ModulesInstance } from '@equinor/fusion-framework-module';
-import type { AnyModule } from '@equinor/fusion-framework-module';
-
-import type { ContextModule } from '@equinor/fusion-framework-module-context';
-import type { EventModule } from '@equinor/fusion-framework-module-event';
-import type { HttpModule } from '@equinor/fusion-framework-module-http';
-import type { MsalModule } from '@equinor/fusion-framework-module-msal';
-import type { ServiceDiscoveryModule } from '@equinor/fusion-framework-module-service-discovery';
-import type { ServicesModule } from '@equinor/fusion-framework-module-services';
-import type { TelemetryModule } from '@equinor/fusion-framework-module-telemetry';
-
-/**
- * Union of all built-in Fusion Framework module descriptors, optionally
- * combined with additional custom modules.
- *
- * Use this type to describe the full set of modules the framework
- * configurator will manage. The built-in set includes:
- * - {@link ContextModule} — application/project context selection
- * - {@link EventModule} — cross-module event bus
- * - {@link HttpModule} — HTTP client factory
- * - {@link MsalModule} — Microsoft Authentication Library integration
- * - {@link ServicesModule} — typed service clients
- * - {@link ServiceDiscoveryModule} — runtime service endpoint resolution
- * - {@link TelemetryModule} — telemetry and logging
- *
- * @template TModules - Additional module descriptors to merge with the
- *   built-in modules. Defaults to `unknown` (no extra modules).
- */
-export type FusionModules<TModules extends Array<AnyModule> | unknown = unknown> = CombinedModules<
-  TModules,
-  [
-    ContextModule,
-    EventModule,
-    HttpModule,
-    MsalModule,
-    ServicesModule,
-    ServiceDiscoveryModule,
-    TelemetryModule,
-  ]
->;
-
-/**
- * Resolved instance map for all Fusion Framework modules.
- *
- * This is the runtime counterpart of {@link FusionModules}: after the
- * framework has been initialized with {@link init}, every module
- * descriptor is replaced by its live instance (clients, providers,
- * managers, etc.).
- *
- * @template TModules - Additional module descriptors whose instances
- *   should be included. Defaults to `unknown`.
- */
-export type FusionModulesInstance<TModules extends Array<AnyModule> | unknown = unknown> =
-  ModulesInstance<FusionModules<TModules>>;
-
-/**
- * Root object returned by {@link init} after bootstrapping the framework.
- *
- * The `Fusion` object is also assigned to `window.Fusion` so that portal
- * shells, micro-frontends, and widgets can access the running framework
- * instance globally.
- *
- * @template TModules - Additional module descriptors beyond the built-in
- *   set. Defaults to `unknown`.
- */
-export interface Fusion<TModules extends Array<AnyModule> | unknown = unknown> {
-  /** Map of all initialized module instances keyed by module name. */
-  modules: FusionModulesInstance<TModules>;
-}
-
-/**
- * Callback signature for rendering a Fusion application into a DOM element.
- *
- * Portal hosts call this function when mounting an application, passing the
- * root element and a reference to the host's module instances so the
- * application can share authentication, HTTP clients, and other services.
- *
- * @param el - The DOM element into which the application should render.
- * @param args - Initialization arguments containing a reference to the
- *   host framework's module instances.
- */
-export type FusionRenderFn = (el: HTMLElement, args: { ref: ModulesInstance<AnyModule[]> }) => void;

package/src/version.ts

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

package/tsconfig.json

@@ -1,36 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist/esm",
-    "rootDir": "src",
-    "declarationDir": "./dist/types"
-  },
-  "references": [
-    {
-      "path": "../modules/module"
-    },
-    {
-      "path": "../modules/event"
-    },
-    {
-      "path": "../modules/telemetry"
-    },
-    {
-      "path": "../modules/http"
-    },
-    {
-      "path": "../modules/msal"
-    },
-    {
-      "path": "../modules/service-discovery"
-    },
-    {
-      "path": "../modules/services"
-    },
-    {
-      "path": "../modules/context"
-    }
-  ],
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "lib"]
-}

package/vitest.config.ts

@@ -1,10 +0,0 @@
-import { defineProject } from 'vitest/config';
-
-import { name, version } from './package.json' with { type: 'json' };
-
-export default defineProject({
-  test: {
-    include: ['src/__tests__/**'],
-    name: `${name}@${version}`,
-  },
-});