@equinor/fusion-framework-module-app 8.0.2 → 8.0.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Change Log
 
+## 8.0.3
+
+### Patch Changes
+
+- 80c3e4a: Internal: resolve `noExplicitAny` Biome warnings in `enableAppModule`'s configurator widening, `AppBundleState`/`AppBundleStateInitial`'s `TModules` generic default, and the `setModule` action creator, using explanatory `biome-ignore` comments. No public API or behavior change.
+- 80c3e4a: Internal: add a required fusion-lint intent comment explaining an `as unknown as AppModuleProvider` cast in the module's `dispose` hook. No behavior change.
+- 80c3e4a: Internal: Resolve fusion-lint warnings across the module — added missing TSDoc comments (including `@inheritdoc` for `IApp` interface implementations), added intent comments for control-flow and RxJS `.pipe()` chains, and referenced tracking issues for existing TODOs (#5123-#5133).
+
+  Split multi-export files into one-symbol-per-file modules for maintainability: `errors.ts` into `errors/*.ts`, `app/flows.ts` into `app/flows/*.ts`, and extracted the `filterEmpty` operator from `app/App.ts` into `app/filter-empty.ts` (re-exported from `App.ts` for backwards compatibility).
+
+- 80c3e4a: Internal: renamed 45 source files across these packages to comply with the `filename-convention` lint rule (e.g. `AIConfigurator.ts` → `AiConfigurator.ts`, `BookmarkProvider.actions.ts` → `bookmark-actions.ts`, `errors/app-build-error.ts` → `errors/AppBuildError.ts`, `plugins/api/plugin.ts` → `plugins/api/ApiPlugin.ts`, `errors.ts` → `UnsupportedApiVersion.ts`, etc.). Also added `enable-signalr.ts` to the `filename-convention` exclude list since the suggested rename would incorrectly split the "SignalR" brand name. No public API changes.
+- 80c3e4a: Internal: added missing intent comments ahead of non-obvious control flow, RxJS `.pipe()` chains, iterator calls, and multi-source object merges to comply with the `require-intent-comment` and `require-tsdoc` lint rules. Also removed dead duplicate files left over from an earlier refactor in `navigation` (`events.ts`, `navigated-event.ts`, `history.flows.ts` — all fully superseded by their split replacements) and renamed `bookmarks/schemas.ts` to `bookmarks/bookmark.schemas.ts` in `services` to match the `*.schemas.ts` filename convention. No public API changes.
+
 ## 8.0.2
 
 ### Patch Changes

package/dist/esm/AppClient.js

@@ -5,7 +5,7 @@ import { HttpJsonResponseError, HttpResponseError, } from '@equinor/fusion-frame
 import { jsonSelector } from '@equinor/fusion-framework-module-http/selectors';
 import { ApiApplicationBuildSchema, ApiApplicationSchema } from './schemas';
 import { AppBuildError, AppConfigError, AppManifestError, AppSettingsError } from './errors';
-import { AppConfigSelector } from './AppClient.Selectors';
+import { AppConfigSelector } from './AppConfigSelector';
 /**
  * Transforms a raw API application response into an {@link AppManifest},
  * adding backwards-compatible `key` and `name` getters.
@@ -16,11 +16,11 @@ const ApplicationSchema = ApiApplicationSchema.transform((x) => {
     const { category, ...props } = x;
     return {
         ...props,
-        // TODO: remove deprecated appKey
+        // TODO(#5124): remove deprecated appKey
         get key() {
             return props.appKey;
         },
-        // TODO: remove deprecated name
+        // TODO(#5124): remove deprecated name
         get name() {
             return props.displayName;
         },
@@ -51,6 +51,10 @@ export class AppClient {
     #build;
     #settings;
     #client;
+    /**
+     * Creates a new {@link AppClient} backed by the given HTTP client.
+     * @param client - The HTTP client used to communicate with the Fusion app service API.
+     */
     constructor(client) {
         this.#client = client;
         const expire = 1 * 60 * 1000;
@@ -133,63 +137,122 @@ export class AppClient {
             expire,
         });
     }
+    /**
+     * Fetches the build metadata for an application.
+     * @param args - Object containing the `appKey` and an optional version `tag`.
+     * @returns An observable that emits the resolved {@link AppBuildManifest}.
+     * @throws {AppBuildError} When the build metadata cannot be loaded.
+     */
     getAppBuild(args) {
-        return this.#build.query(args).pipe(map((res) => res.value), catchError((err) => {
+        // unwrap the build manifest and map errors to a typed AppBuildError
+        return this.#build.query(args).pipe(
+        // unwrap the query result into the build manifest
+        map((res) => res.value), 
+        // map http/unknown errors into a typed AppBuildError
+        catchError((err) => {
             const cause = err?.cause || err;
+            // rethrow already-typed errors as-is
             if (cause instanceof AppBuildError) {
                 throw cause;
             }
+            // map http errors to a typed AppBuildError
             if (cause instanceof HttpJsonResponseError || cause instanceof HttpResponseError) {
                 throw AppBuildError.fromHttpResponse(cause.response, { cause });
             }
             throw new AppBuildError('unknown', 'failed to load build', { cause });
         }));
     }
+    /**
+     * Fetches the manifest for a single application.
+     * @param args - Object containing the `appKey` and an optional version `tag`.
+     * @returns An observable that emits the resolved {@link AppManifest}.
+     * @throws {AppManifestError} When the manifest cannot be loaded.
+     */
     getAppManifest(args) {
-        return this.#manifest.query(args).pipe(queryValue, catchError((err) => {
+        // unwrap the manifest and map errors to a typed AppManifestError
+        return this.#manifest.query(args).pipe(queryValue, 
+        // map http/unknown errors into a typed AppManifestError
+        catchError((err) => {
             const cause = err?.cause || err;
+            // rethrow already-typed errors as-is
             if (cause instanceof AppManifestError) {
                 throw cause;
             }
+            // map http errors to a typed AppManifestError
             if (cause instanceof HttpJsonResponseError || cause instanceof HttpResponseError) {
                 throw AppManifestError.fromHttpResponse(cause.response, { cause });
             }
             throw new AppManifestError('unknown', 'failed to load manifest', { cause });
         }));
     }
+    /**
+     * Fetches manifests for all registered applications.
+     * @param args - Optional filter; set `filterByCurrentUser` to `true` to return only apps the authenticated user has access to.
+     * @returns An observable that emits an array of {@link AppManifest} objects.
+     */
     getAppManifests(args) {
+        // unwrap the query result into the manifest array
         return this.#manifests.query(args).pipe(queryValue);
     }
+    /**
+     * Fetches the runtime configuration for an application.
+     * @template TType - Shape of the `environment` record in the returned config.
+     * @param args - Object containing the `appKey` and an optional version `tag`.
+     * @returns An observable that emits the resolved {@link AppConfig}.
+     * @throws {AppConfigError} When the configuration cannot be loaded.
+     */
     getAppConfig(args) {
-        return this.#config.query(args).pipe(map((res) => res.value), catchError((err) => {
+        // unwrap the config and map errors to a typed AppConfigError
+        return this.#config.query(args).pipe(
+        // unwrap the query result into the config
+        map((res) => res.value), 
+        // map http/unknown errors into a typed AppConfigError
+        catchError((err) => {
             /** handle both direct errors and errors wrapped in a `cause` property */
             const cause = err?.cause || err;
+            // rethrow already-typed errors as-is
             if (cause instanceof AppConfigError) {
                 throw cause;
             }
+            // map http errors to a typed AppConfigError
             if (cause instanceof HttpJsonResponseError || cause instanceof HttpResponseError) {
                 throw AppConfigError.fromHttpResponse(cause.response, { cause });
             }
             throw new AppConfigError('unknown', 'failed to load config', { cause });
         }));
     }
+    /**
+     * Fetches per-user settings for an application.
+     * @param args - Object containing the `appKey`.
+     * @returns An observable that emits the {@link AppSettings} record.
+     * @throws {AppSettingsError} When settings cannot be loaded.
+     */
     getAppSettings(args) {
-        return this.#settings.query(args).pipe(queryValue, catchError((err) => {
+        // unwrap the settings and map errors to a typed AppSettingsError
+        return this.#settings.query(args).pipe(queryValue, 
+        // map http/unknown errors into a typed AppSettingsError
+        catchError((err) => {
             /** handle both direct errors and errors wrapped in a `cause` property */
             const cause = err?.cause || err;
+            // rethrow already-typed errors as-is
             if (cause instanceof AppSettingsError) {
                 throw cause;
             }
+            // map http errors to a typed AppSettingsError
             if (cause instanceof HttpJsonResponseError || cause instanceof HttpResponseError) {
                 throw AppSettingsError.fromHttpResponse(cause.response, { cause });
             }
             throw new AppSettingsError('unknown', 'failed to load settings', { cause });
         }));
     }
+    /**
+     * Persists updated per-user settings for an application via PUT.
+     * @param args - Object containing the `appKey` and the `settings` payload to save.
+     * @returns An observable that emits the persisted {@link AppSettings}.
+     */
     updateAppSettings(args) {
         const { appKey, settings } = args;
         return (this.#client
-            // execute PUT request to update settings
             .json$(`/persons/me/apps/${appKey}/settings`, {
             method: 'PUT',
             body: settings,
@@ -197,6 +260,7 @@ export class AppClient {
                 'Api-Version': '1.0',
             },
         })
+            // update the settings cache with the persisted value
             .pipe(tap((value) => {
             // update cache with new settings
             this.#settings.mutate({ appKey }, {
@@ -205,6 +269,9 @@ export class AppClient {
             });
         })));
     }
+    /**
+     * Disposes of the client, completing all internal query streams.
+     */
     [Symbol.dispose]() {
         console.warn('AppClient disposed');
         this.#manifest.complete();

package/dist/esm/AppClient.js.map

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

package/dist/esm/AppConfig.js

@@ -6,7 +6,9 @@
  * @returns The same object, deeply frozen.
  */
 const deepFreeze = (obj) => {
+    // recursively freeze any nested, unfrozen object properties
     for (const property of Object.keys(obj)) {
+        // only descend into unfrozen object properties
         if (typeof obj[property] === 'object' &&
             obj[property] !== null &&
             !Object.isFrozen(obj[property])) {
@@ -40,16 +42,22 @@ export class AppConfig {
     #environment;
     /**
      * The environment configuration for the application.
+     * @returns The frozen environment configuration.
      */
     get environment() {
         return this.#environment;
     }
     /**
-     * The configuration endpoints for the application,.
+     * The configuration endpoints for the application.
+     * @returns The frozen map of configuration endpoints.
      */
     get endpoints() {
         return this.#endpoints;
     }
+    /**
+     * Creates a new {@link AppConfig}, deep-freezing the provided environment and endpoints.
+     * @param config - The environment and endpoints to initialize the configuration with.
+     */
     constructor(config) {
         this.#environment = deepFreeze(config.environment ?? {});
         this.#endpoints = deepFreeze(config.endpoints ?? {});

package/dist/esm/AppConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppConfig.js","sourceRoot":"","sources":["../../src/AppConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAoC,GAAM,EAAK,EAAE;IAClE,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,IACE,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,QAAQ;YACjC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI;YACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAC/B,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAA4B,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,SAAS;IACpB,UAAU,CAAiC;IAC3C,YAAY,CAAe;IAE3B;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,YAAY,MAGX;QACC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAiB,CAAC;QACzE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,GAAW;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"AppConfig.js","sourceRoot":"","sources":["../../src/AppConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAoC,GAAM,EAAK,EAAE;IAClE,4DAA4D;IAC5D,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,+CAA+C;QAC/C,IACE,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,QAAQ;YACjC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI;YACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAC/B,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAA4B,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,SAAS;IACpB,UAAU,CAAiC;IAC3C,YAAY,CAAe;IAE3B;;;OAGG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,YAAY,MAGX;QACC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAiB,CAAC;QACzE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,GAAW;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/esm/{AppClient.Selectors.js → AppConfigSelector.js}

@@ -16,4 +16,4 @@ export const AppConfigSelector = async (response) => {
     const data = ApiAppConfigSchema.parse(raw);
     return new AppConfig(data);
 };
-//# sourceMappingURL=AppClient.Selectors.js.map
+//# sourceMappingURL=AppConfigSelector.js.map

package/dist/esm/AppConfigSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppConfigSelector.js","sourceRoot":"","sources":["../../src/AppConfigSelector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAEb,MAAM,iDAAiD,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAgC,KAAK,EAAE,QAAQ,EAAE,EAAE;IAC/E,yCAAyC;IACzC,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEzC,qEAAqE;IACrE,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE3C,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC,CAAC"}

package/dist/esm/AppConfigurator.js

@@ -10,7 +10,13 @@ import AppClient from './AppClient';
 export class AppConfigurator extends BaseConfigBuilder {
     defaultExpireTime = 1 * 60 * 1000;
     /**
+     * Creates the default HTTP client for the app service, preferring a pre-configured
+     * client from the http module and falling back to service discovery.
+     *
      * WARNING: this function will be remove in future
+     *
+     * @param init - Module initializer args providing access to the http and service discovery modules.
+     * @returns A promise resolving to the {@link IHttpClient} used to communicate with the app service.
      */
     async _createHttpClient(init) {
         const http = await init.requireInstance('http');
@@ -21,20 +27,39 @@ export class AppConfigurator extends BaseConfigBuilder {
         }
         /** load service discovery module */
         const serviceDiscovery = await init.requireInstance('serviceDiscovery');
-        // TODO - remove when refactor portal service!
+        // TODO(#5125) - remove when refactor portal service!
         /** resolve and create a client from discovery */
         return await serviceDiscovery.createClient(serviceName);
     }
+    /**
+     * Sets the app service client used to fetch manifests, configs, and settings.
+     * @param client_or_cb - A promise resolving to an {@link IAppClient}, or a callback
+     *   that receives module initializer args and returns one.
+     */
     setClient(client_or_cb) {
         const cb = typeof client_or_cb === 'object' ? () => client_or_cb : client_or_cb;
         this._set('client', cb);
     }
-    // TODO - explain why, used in import of resources aka proxy url
+    /**
+     * Sets the base URI used to proxy-load application script bundles.
+     *
+     * TODO(#5132) - explain why, used in import of resources aka proxy url
+     *
+     * @param base_or_cb - A static URI string or a callback returning one.
+     */
     setAssetUri(base_or_cb) {
         const cb = typeof base_or_cb === 'string' ? async () => base_or_cb : base_or_cb;
         this._set('assetUri', cb);
     }
+    /**
+     * Builds the resolved {@link AppModuleConfig}, applying default client and asset URI
+     * when they haven't been explicitly configured.
+     * @param init - Module initializer args used to build the default client.
+     * @param initial - Optional initial partial configuration.
+     * @returns The resolved module config.
+     */
     _createConfig(init, initial) {
+        // fall back to a default client created via the http/service discovery modules
         if (!this._has('client')) {
             this.setClient(async () => {
                 const httpClient = await this._createHttpClient(init);
@@ -42,6 +67,7 @@ export class AppConfigurator extends BaseConfigBuilder {
                 return appClient;
             });
         }
+        // fall back to the default proxy asset uri
         if (!this._has('assetUri')) {
             this.setAssetUri('/apps-proxy');
         }

package/dist/esm/AppConfigurator.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppConfigurator.js","sourceRoot":"","sources":["../../src/AppConfigurator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAGlB,MAAM,kCAAkC,CAAC;AAM1C,OAAO,SAA8B,MAAM,aAAa,CAAC;AA0CzD;;;;;;GAMG;AACH,MAAM,OAAO,eACX,SAAQ,iBAAkC;IAG1C,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAElC;;OAEG;IACO,KAAK,CAAC,iBAAiB,CAC/B,IAAmF;QAEnF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,CAAC;QAC3B,wDAAwD;QACxD,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QAED,oCAAoC;QACpC,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;QAExE,8CAA8C;QAC9C,iDAAiD;QACjD,OAAO,MAAM,gBAAgB,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;IAEM,SAAS,CACd,YAEoD;QAEpD,MAAM,EAAE,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QAChF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,gEAAgE;IACzD,WAAW,CAAC,UAAkD;QACnE,MAAM,EAAE,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QAChF,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAES,aAAa,CACrB,IAAmF,EACnF,OAAkC;QAElC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;gBACxB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBACtD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;gBAC5C,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF"}
+{"version":3,"file":"AppConfigurator.js","sourceRoot":"","sources":["../../src/AppConfigurator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAGlB,MAAM,kCAAkC,CAAC;AAI1C,OAAO,SAA8B,MAAM,aAAa,CAAC;AA0CzD;;;;;;GAMG;AACH,MAAM,OAAO,eACX,SAAQ,iBAAkC;IAG1C,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAElC;;;;;;;;OAQG;IACO,KAAK,CAAC,iBAAiB,CAC/B,IAAmF;QAEnF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,CAAC;QAC3B,wDAAwD;QACxD,IAAI,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QAED,oCAAoC;QACpC,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;QAExE,qDAAqD;QACrD,iDAAiD;QACjD,OAAO,MAAM,gBAAgB,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;IAED;;;;OAIG;IACI,SAAS,CACd,YAEoD;QAEpD,MAAM,EAAE,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QAChF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACI,WAAW,CAAC,UAAkD;QACnE,MAAM,EAAE,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QAChF,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACO,aAAa,CACrB,IAAmF,EACnF,OAAkC;QAElC,+EAA+E;QAC/E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;gBACxB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBACtD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;gBAC5C,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,2CAA2C;QAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/esm/AppModuleProvider.js

@@ -19,6 +19,7 @@ export class AppModuleProvider {
     /**
      * Shallow-compares two app manifests by JSON serialization.
      *
+     * @template T - The manifest type being compared.
      * @param a - First manifest to compare.
      * @param b - Second manifest to compare.
      * @returns `true` if the serialized manifests are identical.
@@ -33,6 +34,7 @@ export class AppModuleProvider {
     #event;
     /**
      * Get module version
+     * @returns The module's semantic version.
      */
     get version() {
         return new SemanticVersion(version);
@@ -43,6 +45,8 @@ export class AppModuleProvider {
      * - `undefined` – no application has been set yet.
      * - `null` – the current application was explicitly cleared.
      * - `App` – an active application instance.
+     *
+     * @returns The current active application, `null` if cleared, or `undefined` if never set.
      */
     get current() {
         return this.#current$.value;
@@ -52,9 +56,13 @@ export class AppModuleProvider {
      *
      * Emits are deduplicated by `appKey`; re-setting the same app does not trigger
      * a new emission.
+     *
+     * @returns An observable of the current active application.
      */
     get current$() {
+        // dedupe emissions when the current app's key is unchanged
         return this.#current$.pipe(distinctUntilChanged((prev, next) => {
+            // compare by appKey when both are set, otherwise fall back to reference equality
             if (prev && next) {
                 return prev.appKey === next.appKey;
             }
@@ -74,6 +82,7 @@ export class AppModuleProvider {
         this.#current$ = new BehaviorSubject(undefined);
         this.#appBaseUri = config.assetUri ?? '';
         this.#subscription.add(this.current$
+            // dispatch a lifecycle event whenever the current app changes
             .pipe(pairwise(), takeWhile(() => !!event))
             .subscribe(([previous, next]) => {
             event?.dispatchEvent('onCurrentAppChanged', {
@@ -82,6 +91,7 @@ export class AppModuleProvider {
             });
         }));
         this.#subscription.add(this.#current$
+            // dispose the previous app once it has been replaced
             .pipe(pairwise(), map(([previous]) => previous), filterEmpty())
             .subscribe((app) => app.dispose()));
     }
@@ -108,6 +118,7 @@ export class AppModuleProvider {
     /**
      * fetch all applications
      * @deprecated use `getAppManifests` instead
+     * @returns An observable that emits an array of {@link AppManifest} objects.
      */
     getAllAppManifests() {
         return this.getAppManifests();
@@ -151,11 +162,13 @@ export class AppModuleProvider {
      * @param appKeyOrApp - Application key, app reference, or an existing `IApp` instance.
      */
     setCurrentApp(appKeyOrApp) {
+        // a plain string is treated as an appKey to create a new App from
         if (typeof appKeyOrApp === 'string') {
             const newApp = new App({ appKey: appKeyOrApp }, { provider: this, event: this.#event });
             this.#current$.next(newApp);
             return;
         }
+        // an object with appKey and tag is treated as an AppReference to create a new App from
         if (appKeyOrApp.appKey && 'tag' in appKeyOrApp) {
             const newApp = new App({ appKey: appKeyOrApp.appKey, tag: appKeyOrApp.tag }, { provider: this, event: this.#event });
             this.#current$.next(newApp);
@@ -172,6 +185,7 @@ export class AppModuleProvider {
     }
     /**
      * Base URI used for proxying application script imports.
+     * @returns The configured asset base URI.
      */
     get assetUri() {
         return this.#appBaseUri;
@@ -179,6 +193,8 @@ export class AppModuleProvider {
     /**
      * This should not be used, only for legacy creation backdoor
      * @deprecated
+     * @param value - The initial app bundle state to construct the app from.
+     * @returns The newly created {@link App} instance.
      */
     createApp(value) {
         console.warn('AppModuleProvider.createApp is deprecated and should not be used.');

package/dist/esm/AppModuleProvider.js.map

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