@equinor/fusion-framework-module-app 8.0.4 → 8.1.0-next.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Change Log
 
+## 8.1.0-next.0
+
+### Minor Changes
+
+- 2836e0b: Add `MockAppClient`, exported from a new `./mock` subpath, so a test can serve one app's own manifest and config locally instead of contacting the app service.
+
+  ```ts
+  import { MockAppClient } from "@equinor/fusion-framework-module-app/mock";
+
+  enableAppModule(configurator, (builder) => {
+    builder.setClient(async ({ requireInstance }) => {
+      const http = await requireInstance("http");
+      return new MockAppClient(http.createClient("apps"), manifest, config);
+    });
+  });
+  ```
+
+  `getAppManifest` only resolves locally for `manifest.appKey` with no `tag` at all. `getAppConfig` resolves for `manifest.appKey` when `tag` is either absent or equal to the manifest's own `build.version` — the same tag `App` requests when loading config for the manifest it already resolved. Every other request — other app keys, tagged requests, builds, settings — still goes through the real `AppClient` it wraps, so pointing service discovery at a different registry or a real local mock server keeps working unchanged.
+
+  Also export `AppConfig` as a value from the package root (previously type-only), so a test can construct one directly with `new AppConfig({ environment, endpoints })`.
+
+### Patch Changes
+
+- e8aae1f: Internal: publish every package on the `next` pre-release tag so the whole framework can be installed as a coherent set.
+
+  Packages without their own changes are bumped only to receive a `-next.N` version and the `next` dist-tag on npm. Install with:
+
+  ```bash
+  pnpm add @equinor/fusion-framework-react-app@next
+  ```
+
+- Updated dependencies [e8aae1f]
+- Updated dependencies [2836e0b]
+  - @equinor/fusion-observable@9.1.2-next.0
+  - @equinor/fusion-query@7.0.4-next.0
+
 ## 8.0.4
 
 ### Patch Changes

package/README.md

@@ -117,6 +117,36 @@ All API requests map HTTP status codes to typed error classes:
 
 Each error includes a `type` property (`'not_found'`, `'unauthorized'`, `'deleted'`, or `'unknown'`) for programmatic handling.
 
+## Testing
+
+Import from `@equinor/fusion-framework-module-app/mock` to serve one app's manifest
+and config locally instead of contacting the app service. The real `AppClient`
+still backs every other request — other app keys, tagged requests, builds,
+settings — so pointing `setClient` at a different http client or service
+discovery registry keeps working unchanged.
+
+```ts
+import { MockAppClient } from '@equinor/fusion-framework-module-app/mock';
+
+enableAppModule(configurator, (builder) => {
+  builder.setClient(async ({ requireInstance }) => {
+    const http = await requireInstance('http');
+    return new MockAppClient(http.createClient('apps'), manifest, config);
+  });
+});
+```
+
+`getAppManifest` only resolves locally for `manifest.appKey` with no `tag` at
+all. `getAppConfig` resolves for `manifest.appKey` when `tag` is either absent
+or equal to the manifest's own `build.version` — the same tag `App` requests
+when loading config for the manifest it already resolved. Any other app key,
+tag, or the wrong request falls through to the real client.
+
+> [!NOTE]
+> `@equinor/fusion-framework-app/mock`'s `mockAppModules` builds on top of this
+> class and is usually the simpler entry point for testing an application —
+> see its [Testing](../../app/docs/testing.md) guide.
+
 ## Main Exports
 
 | Export               | Description                                      |
@@ -127,4 +157,5 @@ Each error includes a `type` property (`'not_found'`, `'unauthorized'`, `'delete
 | `AppConfigurator`    | Configuration builder for module setup            |
 | `AppConfig`          | Immutable app configuration (env + endpoints)     |
 | `App` / `IApp`       | Application instance with reactive state          |
-| `AppModule`          | Module definition for the framework               |
+| `AppModule`          | Module definition for the framework               |
+| `MockAppClient`      | Test double serving one app's manifest and config locally (`/mock`) |

package/dist/esm/__tests__/AppModuleProvider.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { mockFramework } from '@equinor/fusion-framework/mock';
+import { createRouterMiddleware } from '@equinor/fusion-framework-module-http/mock';
+import { enableAppModule } from '../enable-app-module';
+/**
+ * Boots a full portal-shaped framework instance the same way `packages/dev-portal`'s
+ * `configure.ts` does — `enableAppModule` registered directly on the portal's own
+ * configurator, alongside its real `http`, `event`, `msal`, etc. — rather than a
+ * standalone module graph assembled just for this test. Only the network call
+ * itself is faked; the app module creates its client eagerly during its own
+ * `requireInstance('http')` in the SAME configure→initialize pipeline, so this also
+ * verifies middleware registered before `initialize()` reaches that client.
+ */
+const initializePortalWith = () => mockFramework((configurator) => {
+    configurator.http.configureClient('apps', { baseUri: 'https://apps.example.com' });
+    configurator.http.addMiddleware(createRouterMiddleware('https://apps.example.com', (router) => {
+        router.get('/persons/me/apps/:appKey', ({ params }) => Response.json({
+            appKey: params.appKey,
+            displayName: 'Test App',
+            description: 'A test application',
+            type: 'standalone',
+        }));
+    }));
+    enableAppModule(configurator);
+});
+describe('AppModuleProvider', () => {
+    it("fetches the manifest through the portal's own http client once a current app is set", async () => {
+        const fusion = await initializePortalWith();
+        fusion.modules.app.setCurrentApp('test-app');
+        await expect(fusion.modules.app.current?.getManifestAsync()).resolves.toMatchObject({
+            appKey: 'test-app',
+            displayName: 'Test App',
+        });
+    });
+});
+//# sourceMappingURL=AppModuleProvider.test.js.map

package/dist/esm/__tests__/AppModuleProvider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppModuleProvider.test.js","sourceRoot":"","sources":["../../../src/__tests__/AppModuleProvider.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GAAG,GAAG,EAAE,CAChC,aAAa,CAAc,CAAC,YAAY,EAAE,EAAE;IAC1C,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACnF,YAAY,CAAC,IAAI,CAAC,aAAa,CAC7B,sBAAsB,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,EAAE;QAC5D,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CACpD,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,oBAAoB;YACjC,IAAI,EAAE,YAAY;SACnB,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IACF,eAAe,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AAEL,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,qFAAqF,EAAE,KAAK,IAAI,EAAE;QACnG,MAAM,MAAM,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAE5C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAE7C,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;YAClF,MAAM,EAAE,UAAU;YAClB,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/esm/__tests__/MockAppClient.test.js

@@ -0,0 +1,70 @@
+import { firstValueFrom, of } from 'rxjs';
+import { describe, expect, it, vi } from 'vitest';
+import { AppClient } from '../AppClient.js';
+import { AppConfig } from '../AppConfig.js';
+import { MockAppClient } from '../mock/MockAppClient.js';
+const manifest = {
+    appKey: 'my-app',
+    displayName: 'My App',
+    description: 'My app',
+    type: 'standalone',
+    build: { version: '1.2.3', entryPoint: 'index.js' },
+};
+const config = new AppConfig({ environment: { key: 'value' } });
+// never invoked directly -- both overrides either answer locally or delegate through
+// the spied `AppClient.prototype` methods below, so the real client is never called
+const client = {};
+describe('MockAppClient', () => {
+    describe('getAppManifest', () => {
+        it('answers locally for its own app key with no tag', async () => {
+            const mockClient = new MockAppClient(client, manifest);
+            const result = mockClient.getAppManifest({ appKey: 'my-app' });
+            await expect(firstValueFrom(result)).resolves.toBe(manifest);
+        });
+        it('delegates for its own app key with an explicit empty-string tag', () => {
+            const delegate = vi
+                .spyOn(AppClient.prototype, 'getAppManifest')
+                .mockReturnValue(of(manifest));
+            const mockClient = new MockAppClient(client, manifest);
+            mockClient.getAppManifest({ appKey: 'my-app', tag: '' });
+            expect(delegate).toHaveBeenCalledWith({ appKey: 'my-app', tag: '' });
+            delegate.mockRestore();
+        });
+        it('delegates for a different app key', () => {
+            const delegate = vi
+                .spyOn(AppClient.prototype, 'getAppManifest')
+                .mockReturnValue(of(manifest));
+            const mockClient = new MockAppClient(client, manifest);
+            mockClient.getAppManifest({ appKey: 'other-app' });
+            expect(delegate).toHaveBeenCalledWith({ appKey: 'other-app' });
+            delegate.mockRestore();
+        });
+    });
+    describe('getAppConfig', () => {
+        it('answers locally for its own app key with no tag', async () => {
+            const mockClient = new MockAppClient(client, manifest, config);
+            const result = mockClient.getAppConfig({ appKey: 'my-app' });
+            await expect(firstValueFrom(result)).resolves.toBe(config);
+        });
+        it("answers locally for its own app key with a tag matching the manifest's build version", async () => {
+            const mockClient = new MockAppClient(client, manifest, config);
+            const result = mockClient.getAppConfig({ appKey: 'my-app', tag: '1.2.3' });
+            await expect(firstValueFrom(result)).resolves.toBe(config);
+        });
+        it('delegates for its own app key with an explicit empty-string tag', () => {
+            const delegate = vi.spyOn(AppClient.prototype, 'getAppConfig').mockReturnValue(of(config));
+            const mockClient = new MockAppClient(client, manifest, config);
+            mockClient.getAppConfig({ appKey: 'my-app', tag: '' });
+            expect(delegate).toHaveBeenCalledWith({ appKey: 'my-app', tag: '' });
+            delegate.mockRestore();
+        });
+        it('delegates for its own app key with a tag not matching the manifest build version', () => {
+            const delegate = vi.spyOn(AppClient.prototype, 'getAppConfig').mockReturnValue(of(config));
+            const mockClient = new MockAppClient(client, manifest, config);
+            mockClient.getAppConfig({ appKey: 'my-app', tag: '9.9.9' });
+            expect(delegate).toHaveBeenCalledWith({ appKey: 'my-app', tag: '9.9.9' });
+            delegate.mockRestore();
+        });
+    });
+});
+//# sourceMappingURL=MockAppClient.test.js.map

package/dist/esm/__tests__/MockAppClient.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockAppClient.test.js","sourceRoot":"","sources":["../../../src/__tests__/MockAppClient.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -18,6 +18,7 @@
  */
 export { AppConfigurator, } from './AppConfigurator';
 export { AppClient } from './AppClient';
+export { AppConfig } from './AppConfig';
 export { AppModuleProvider } from './AppModuleProvider';
 export * from './events';
 export * from './types';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,eAAe,GAGhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAa,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,eAAe,GAGhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAa,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/mock/MockAppClient.js

@@ -0,0 +1,65 @@
+import { of } from 'rxjs';
+import { AppClient } from '../AppClient.js';
+/**
+ * An {@link AppClient} that answers `getAppManifest` and `getAppConfig` for one
+ * known app locally, delegating everything else — other app keys, tagged
+ * requests, builds, settings — to the real client it wraps.
+ *
+ * @remarks
+ * Whatever `client` was resolved to (a pre-configured http client, or one created
+ * through service discovery) still backs every method this class doesn't
+ * override, so pointing service discovery at a different registry or a real
+ * local mock server keeps working unchanged.
+ *
+ * @example
+ * ```ts
+ * builder.setClient(async ({ requireInstance }) => {
+ *   const http = await requireInstance('http');
+ *   return new MockAppClient(http.createClient('apps'), manifest, config);
+ * });
+ * ```
+ */
+export class MockAppClient extends AppClient {
+    #manifest;
+    #config;
+    /**
+     * @param client - The real {@link IHttpClient} to delegate all other requests to.
+     * @param manifest - The manifest to return for `getAppManifest({ appKey: manifest.appKey })`.
+     * @param config - The config to return for `getAppConfig({ appKey: manifest.appKey })`, if any.
+     */
+    constructor(client, manifest, config) {
+        super(client);
+        this.#manifest = manifest;
+        this.#config = config;
+    }
+    /**
+     * Answers with the manifest passed to the constructor when `args` matches
+     * this client's own app key and no tag; otherwise delegates to the real client.
+     *
+     * @param args - The app key and optional tag to resolve a manifest for.
+     * @returns An observable of the resolved {@link AppManifest}.
+     */
+    getAppManifest(args) {
+        return args.appKey === this.#manifest.appKey && args.tag === undefined
+            ? of(this.#manifest)
+            : super.getAppManifest(args);
+    }
+    /**
+     * Answers with the config passed to the constructor when `args` matches this
+     * client's own app key and tag; otherwise delegates to the real client.
+     *
+     * @template TType - The shape of the config's `environment` data.
+     * @param args - The app key and optional tag to resolve config for.
+     * @returns An observable of the resolved {@link AppConfig}.
+     */
+    getAppConfig(args) {
+        // config is fetched against the manifest's own build version, not an explicit override tag,
+        // so a matching tag is treated the same as an absent one -- an explicit empty string is not
+        const isOwnTag = args.tag === undefined || args.tag === this.#manifest.build?.version;
+        return args.appKey === this.#manifest.appKey && isOwnTag && this.#config
+            ? of(this.#config)
+            : super.getAppConfig(args);
+    }
+}
+export default MockAppClient;
+//# sourceMappingURL=MockAppClient.js.map

package/dist/esm/mock/MockAppClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockAppClient.js","sourceRoot":"","sources":["../../../src/mock/MockAppClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAI1B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,SAAS,CAAc;IACvB,OAAO,CAAa;IAEpB;;;;OAIG;IACH,YAAY,MAAmB,EAAE,QAAqB,EAAE,MAAkB;QACxE,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;;;;;OAMG;IACM,cAAc,CAAC,IAAsC;QAC5D,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;YACpE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;YACpB,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACM,YAAY,CAAsD,IAG1E;QACC,4FAA4F;QAC5F,4FAA4F;QAC5F,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC;QACtF,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,QAAQ,IAAI,IAAI,CAAC,OAAO;YACtE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAA2B,CAAC;YACtC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,eAAe,aAAa,CAAC"}

package/dist/esm/mock/index.js

@@ -0,0 +1,13 @@
+/**
+ * Test doubles for the app module.
+ *
+ * @remarks
+ * Imported from `@equinor/fusion-framework-module-app/mock`, so the mock ships
+ * and versions with the implementation it stands in for.
+ *
+ * This entry point has no dependency on any test runner.
+ *
+ * @packageDocumentation
+ */
+export { MockAppClient } from './MockAppClient.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/mock/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mock/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/schemas.js

@@ -52,6 +52,25 @@ const ApiApplicationPersonSchema = z.object({
     })
         .nullish(),
 });
+/**
+ * Schema for validating the options object on application builds.
+ *
+ * Known properties:
+ * - `contextRouting` (optional): Routing strategy for context — `'path'` or `'query'`.
+ *
+ * The schema uses `.catchall(z.unknown())` to permit additional properties
+ * at runtime without requiring them to be declared here. Add known properties
+ * to this schema as they are introduced.
+ */
+export const FrameworkOptionsSchema = z
+    .object({
+    contextRouting: z
+        .enum(['path', 'query'], {
+        message: "The routing strategy for context, which can be either 'path' or 'query'.",
+    })
+        .nullish(),
+})
+    .catchall(z.unknown());
 /**
  * Schema for validating the structure of an API application build.
  *
@@ -67,6 +86,7 @@ const ApiApplicationPersonSchema = z.object({
  * - `githubRepo`: An optional GitHub repository associated with the build.
  * - `projectPage`: An optional project page URL.
  * - `allowedExtensions`: An optional array of allowed extensions for the build.
+ * - `options`: An optional record of additional build options, where the key is a string and the value can be of any type.
  * - `uploadedBy`: An optional schema for the person who uploaded the build.
  */
 // Deliberately co-located with ApiApplicationPersonSchema, which it depends on
@@ -82,6 +102,9 @@ export const ApiApplicationBuildSchema = z.object({
     commitSha: z.string().nullish(),
     githubRepo: z.string().nullish(),
     projectPage: z.string().nullish(),
+    options: FrameworkOptionsSchema.nullish().default({
+        contextRouting: 'path',
+    }),
     allowedExtensions: z.array(z.string()).nullish(),
     uploadedBy: ApiApplicationPersonSchema.nullish(),
 });

package/dist/esm/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '8.0.4';
+export const version = '8.1.0-next.0';
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC"}