@equinor/fusion-framework-module-app 6.0.3 → 6.1.0

package/dist/types/AppClient.d.ts

@@ -1,6 +1,6 @@
 import { Observable, ObservableInput } from 'rxjs';
 import { IHttpClient } from '@equinor/fusion-framework-module-http';
-import type { AppConfig, AppManifest, ConfigEnvironment } from './types';
+import type { AppConfig, AppManifest, AppSettings, ConfigEnvironment } from './types';
 export interface IAppClient extends Disposable {
     /**
      * Fetch app manifest by appKey
@@ -21,6 +21,21 @@ export interface IAppClient extends Disposable {
         appKey: string;
         tag?: string;
     }) => ObservableInput<AppConfig<TType>>;
+    /**
+     * Fetch app settings by appKey
+     */
+    getAppSettings: (args: {
+        appKey: string;
+    }) => ObservableInput<AppSettings>;
+    /**
+     * Set app settings by appKey
+     * @param args - Object with appKey and settings
+     * @returns ObservableInput<AppSettings>
+     */
+    updateAppSettings: (args: {
+        appKey: string;
+        settings: AppSettings;
+    }) => ObservableInput<AppSettings>;
 }
 /**
  * The `AppClient` class implements the `IAppClient` interface and provides methods to query
@@ -39,6 +54,13 @@ export declare class AppClient implements IAppClient {
         appKey: string;
         tag?: string;
     }): Observable<AppConfig<TType>>;
+    getAppSettings(args: {
+        appKey: string;
+    }): Observable<AppSettings>;
+    updateAppSettings(args: {
+        appKey: string;
+        settings: AppSettings;
+    }): Observable<AppSettings>;
     [Symbol.dispose](): void;
 }
 export default AppClient;

package/dist/types/AppModuleProvider.d.ts

@@ -1,7 +1,7 @@
 import { Observable } from 'rxjs';
 import { ModuleType } from '@equinor/fusion-framework-module';
 import { EventModule } from '@equinor/fusion-framework-module-event';
-import type { AppConfig, AppManifest, ConfigEnvironment, CurrentApp } from './types';
+import type { AppConfig, AppManifest, AppSettings, ConfigEnvironment, CurrentApp } from './types';
 import { App, IApp } from './app/App';
 import { AppModuleConfig } from './AppConfigurator';
 import { AppBundleStateInitial } from './app/types';
@@ -39,6 +39,17 @@ export declare class AppModuleProvider {
      * @param appKey - application key
      */
     getAppConfig<TType extends ConfigEnvironment = ConfigEnvironment>(appKey: string, tag?: string): Observable<AppConfig<TType>>;
+    /**
+     * fetch user settings for an application
+     * @param appKey - application key
+     */
+    getAppSettings(appKey: string): Observable<AppSettings>;
+    /**
+     * Put user settings for an application
+     * @param appKey - application key
+     * @param settings - The settings to add save
+     */
+    updateAppSettings(appKey: string, settings: AppSettings): Observable<AppSettings>;
     /**
      * set the current application, will internally resolve manifest
      * @param appKey - application key

package/dist/types/app/App.d.ts

@@ -1,7 +1,7 @@
-import type { AppModulesInstance, AppScriptModule, AppManifest, AppConfig, ConfigEnvironment } from '../types';
+import type { AppModulesInstance, AppScriptModule, AppManifest, AppConfig, AppSettings, ConfigEnvironment } from '../types';
 import { Observable } from '@equinor/fusion-observable';
 import type { AppModuleProvider } from '../AppModuleProvider';
-import { OperatorFunction } from 'rxjs';
+import { type OperatorFunction } from 'rxjs';
 import { EventModule } from '@equinor/fusion-framework-module-event';
 import { AnyModule, ModuleType } from '@equinor/fusion-framework-module';
 import { AppBundleState, AppBundleStateInitial } from './types';
@@ -33,6 +33,16 @@ export interface IApp<TEnv extends ConfigEnvironment = ConfigEnvironment, TModul
      * @returns An observable that emits the instance of the app modules.
      */
     get instance$(): Observable<AppModulesInstance<TModules>>;
+    /**
+     * Observable that emits the settings of the app.
+     * @returns An Observable that emits the app settings.
+     */
+    get settings$(): Observable<AppSettings>;
+    /**
+     * Observable that emits the status of the app.
+     * @returns An Observable that emits the app status.
+     */
+    get status$(): Observable<AppBundleState['status']>;
     /**
      * Gets the current state of the Application.
      * @returns The current state of the Application.
@@ -108,6 +118,44 @@ export interface IApp<TEnv extends ConfigEnvironment = ConfigEnvironment, TModul
      * @returns A promise that resolves to the AppConfig.
      */
     getConfigAsync(allow_cache?: boolean): Promise<AppConfig>;
+    /**
+     * Gets the app settings.
+     * @param force_refresh Whether to force refreshing the settings.
+     * @returns An observable that emits the app settings.
+     */
+    getSettings(force_refresh?: boolean): Observable<AppSettings>;
+    /**
+     * Retrieves the app settings asynchronously.
+     * @param allow_cache Whether to allow loading from cache.
+     * @returns A promise that resolves to the AppSettings.
+     */
+    getSettingsAsync(allow_cache?: boolean): Promise<AppSettings>;
+    /**
+     * Sets the app settings.
+     * @param settings The settings object to save.
+     * @returns An observable that emits the app settings.
+     */
+    updateSettings<T extends AppSettings>(settings: T): Observable<T>;
+    /**
+     * Sets the app settings asyncronously.
+     * @param settings The settings object to save.
+     * @returns An Promise that resolves the app settings.
+     */
+    updateSettingsAsync<T extends AppSettings>(settings: T): Promise<T>;
+    /**
+     * Updates a specific setting of the app.
+     * @param property The property to update.
+     * @param value The value to set.
+     * @returns An observable that emits the app settings.
+     */
+    updateSetting<T extends AppSettings, P extends keyof T>(property: P, value: T[P]): Observable<T[P]>;
+    /**
+     * Updates a specific setting of the app asynchronously.
+     * @param property The property to update.
+     * @param value The value to set.
+     * @returns A promise that resolves to the AppSettings.
+     */
+    updateSettingAsync<T extends AppSettings, P extends keyof T>(property: P, value: T[P]): Promise<T[P]>;
     /**
      * Gets the app manifest.
      * @param force_refresh Whether to force refreshing the manifest.
@@ -139,6 +187,8 @@ export declare class App<TEnv extends ConfigEnvironment = ConfigEnvironment, TMo
     get config$(): Observable<AppConfig<TEnv>>;
     get modules$(): Observable<AppScriptModule>;
     get instance$(): Observable<AppModulesInstance<TModules>>;
+    get settings$(): Observable<AppSettings>;
+    get status$(): Observable<AppBundleState['status']>;
     get state(): Readonly<AppBundleState>;
     get appKey(): string;
     get manifest(): Readonly<AppManifest> | undefined;
@@ -161,6 +211,12 @@ export declare class App<TEnv extends ConfigEnvironment = ConfigEnvironment, TMo
     loadAppModule(allow_cache?: boolean): Promise<void>;
     getConfig(force_refresh?: boolean): Observable<AppConfig>;
     getConfigAsync(allow_cache?: boolean): Promise<AppConfig>;
+    getSettings<T extends AppSettings>(force_refresh?: boolean): Observable<T>;
+    getSettingsAsync<T extends AppSettings>(allow_cache?: boolean): Promise<T>;
+    updateSettings<T extends AppSettings>(settings: T): Observable<T>;
+    updateSettingsAsync<T extends AppSettings>(settings: T): Promise<T>;
+    updateSetting<T extends AppSettings, P extends keyof T>(property: P, value: T[P]): Observable<T[P]>;
+    updateSettingAsync<T extends AppSettings, P extends keyof T>(property: P, value: T[P]): Promise<T[P]>;
     getManifest(force_refresh?: boolean): Observable<AppManifest>;
     getManifestAsync(allow_cache?: boolean): Promise<AppManifest>;
     getAppModule(force_refresh?: boolean): Observable<AppScriptModule>;

package/dist/types/app/actions.d.ts

@@ -1,5 +1,5 @@
 import { ActionInstanceMap, ActionTypes } from '@equinor/fusion-observable';
-import type { AppConfig, AppManifest, AppModulesInstance, AppScriptModule } from '../types';
+import type { AppConfig, AppManifest, AppModulesInstance, AppScriptModule, AppSettings } from '../types';
 declare const createActions: () => {
     /** Manifest loading */
     setManifest: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[manifest: AppManifest, update?: boolean | undefined], AppManifest, "set_manifest", never, {
@@ -18,6 +18,24 @@ declare const createActions: () => {
         success: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[config: AppConfig<import("../AppConfig").ConfigEnvironment>], AppConfig<import("../AppConfig").ConfigEnvironment>, "fetch_config::success", never, never>;
         failure: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[error: unknown], unknown, "fetch_config::failure", never, never>;
     };
+    /** Settings loading */
+    setSettings: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[settings?: AppSettings | undefined], AppSettings | undefined, "set_settings", never, never>;
+    /** Fetching settings */
+    fetchSettings: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[appKey: string], {
+        appKey: string;
+    }, "fetch_settings::request", never, never> & {
+        success: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[settings: AppSettings], AppSettings, "fetch_settings::success", never, never>;
+        failure: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[error: unknown], unknown, "fetch_settings::failure", never, never>;
+    };
+    /** Updating settings */
+    updateSettings: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[appKey: string, settings: AppSettings], {
+        appKey: string;
+        settings: AppSettings;
+    }, "update_settings::request", never, never> & {
+        success: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[settings: AppSettings], AppSettings, "update_settings::success", never, never>;
+        failure: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[error: unknown], unknown, "update_settings::failure", never, never>;
+    };
+    updateSettingsAbort: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[id: string], string, "update_settings::abort", never, never>;
     /** App loading */
     setModule: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[module: any], any, "set_module", never, never>;
     importApp: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[entrypoint: string], string, "import_app::request", never, never> & {
@@ -48,6 +66,24 @@ export declare const actions: {
         success: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[config: AppConfig<import("../AppConfig").ConfigEnvironment>], AppConfig<import("../AppConfig").ConfigEnvironment>, "fetch_config::success", never, never>;
         failure: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[error: unknown], unknown, "fetch_config::failure", never, never>;
     };
+    /** Settings loading */
+    setSettings: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[settings?: AppSettings | undefined], AppSettings | undefined, "set_settings", never, never>;
+    /** Fetching settings */
+    fetchSettings: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[appKey: string], {
+        appKey: string;
+    }, "fetch_settings::request", never, never> & {
+        success: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[settings: AppSettings], AppSettings, "fetch_settings::success", never, never>;
+        failure: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[error: unknown], unknown, "fetch_settings::failure", never, never>;
+    };
+    /** Updating settings */
+    updateSettings: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[appKey: string, settings: AppSettings], {
+        appKey: string;
+        settings: AppSettings;
+    }, "update_settings::request", never, never> & {
+        success: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[settings: AppSettings], AppSettings, "update_settings::success", never, never>;
+        failure: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[error: unknown], unknown, "update_settings::failure", never, never>;
+    };
+    updateSettingsAbort: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[id: string], string, "update_settings::abort", never, never>;
     /** App loading */
     setModule: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[module: any], any, "set_module", never, never>;
     importApp: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[entrypoint: string], string, "import_app::request", never, never> & {

package/dist/types/app/create-reducer.d.ts

@@ -10,6 +10,23 @@ export declare const createReducer: (value: AppBundleStateInitial) => import("@e
 } | {
     payload: import("..").AppManifest;
     type: "fetch_config::request";
+} | {
+    payload: import("..").AppSettings | undefined;
+    type: "set_settings";
+} | {
+    payload: {
+        appKey: string;
+    };
+    type: "fetch_settings::request";
+} | {
+    payload: {
+        appKey: string;
+        settings: import("..").AppSettings;
+    };
+    type: "update_settings::request";
+} | {
+    payload: string;
+    type: "update_settings::abort";
 } | {
     payload: any;
     type: "set_module";
@@ -34,6 +51,18 @@ export declare const createReducer: (value: AppBundleStateInitial) => import("@e
 } | {
     payload: unknown;
     type: "fetch_config::failure";
+} | {
+    payload: import("..").AppSettings;
+    type: "fetch_settings::success";
+} | {
+    payload: unknown;
+    type: "fetch_settings::failure";
+} | {
+    payload: import("..").AppSettings;
+    type: "update_settings::success";
+} | {
+    payload: unknown;
+    type: "update_settings::failure";
 } | {
     payload: import("..").AppScriptModule;
     type: "import_app::success";

package/dist/types/app/events.d.ts

@@ -1,6 +1,6 @@
 import type { FrameworkEvent, FrameworkEventInit } from '@equinor/fusion-framework-module-event';
 import type { App } from './App';
-import type { AppConfig, AppManifest, AppModulesInstance, AppScriptModule } from '../types';
+import type { AppConfig, AppManifest, AppModulesInstance, AppScriptModule, AppSettings } from '../types';
 /** base event type for applications */
 export type AppEventEventInit<TDetail extends Record<string, unknown> | unknown = unknown> = FrameworkEventInit<
 /** additional event details and key of target event */
@@ -32,6 +32,17 @@ declare module '@equinor/fusion-framework-module-event' {
             config: AppConfig;
         }>;
         onAppConfigFailure: AppEventFailure;
+        onAppSettingsLoad: AppEvent;
+        /** fired when the application has loaded corresponding settings */
+        onAppSettingsLoaded: AppEvent<{
+            settings: AppSettings;
+        }>;
+        onAppSettingsFailure: AppEventFailure;
+        onAppSettingsUpdate: AppEvent;
+        onAppSettingsUpdated: AppEvent<{
+            settings: AppSettings;
+        }>;
+        onAppSettingsUpdateFailure: AppEventFailure;
         /** fired when the application has loaded corresponding javascript module */
         onAppScriptLoad: AppEvent;
         onAppScriptLoaded: AppEvent<{

package/dist/types/app/flows.d.ts

@@ -18,6 +18,22 @@ export declare const handleFetchManifest: (provider: AppModuleProvider) => Flow<
  * @returns A Flow function that takes an Observable of actions and returns an Observable of actions.
  */
 export declare const handleFetchConfig: (provider: AppModuleProvider) => Flow<Actions, AppBundleState>;
+/**
+ * Handles the fetch settings action by fetching the app settings from the provider,
+ * filtering out null values, and dispatching success or failure actions accordingly.
+ *
+ * @param provider The AppModuleProvider used to fetch the app settings.
+ * @returns A Flow function that takes an Observable of actions and returns an Observable of actions.
+ */
+export declare const handleFetchSettings: (provider: AppModuleProvider) => Flow<Actions, AppBundleState>;
+/**
+ * Handles the set settings action by setting the app settings from the provider,
+ * filtering out null values, and dispatching success or failure actions accordingly.
+ *
+ * @param provider The AppModuleProvider used to fetch the app settings.
+ * @returns A Flow function that takes an Observable of actions and returns an Observable of actions.
+ */
+export declare const handleUpdateSettings: (provider: AppModuleProvider) => Flow<Actions, AppBundleState>;
 /**
  * Handles the import application flow.
  * @returns A flow that takes in actions and returns an observable of AppBundleState.

package/dist/types/app/types.d.ts

@@ -1,4 +1,6 @@
-import type { AppManifest, AppConfig, AppModulesInstance, AppScriptModule, ConfigEnvironment } from '../types';
+import { ActionBaseType } from '@equinor/fusion-observable';
+import type { AppManifest, AppConfig, AppModulesInstance, AppScriptModule, ConfigEnvironment, AppSettings } from '../types';
+import { Actions } from './actions';
 /**
  * Represents the state of an application bundle.
  *
@@ -9,14 +11,16 @@ import type { AppManifest, AppConfig, AppModulesInstance, AppScriptModule, Confi
  * @property {Set<string>} status - A set of strings representing the status of the application.
  * @property {AppManifest} [manifest] - An optional manifest describing the application.
  * @property {AppConfig<TConfig>} [config] - An optional configuration object for the application.
+ * @property {AppSettings} [settings] - An optional application settings object.
  * @property {AppScriptModule} [modules] - An optional script module for the application.
  * @property {AppModulesInstance<TModules>} [instance] - An optional instance of the application modules.
  */
 export type AppBundleState<TConfig extends ConfigEnvironment = ConfigEnvironment, TModules = any> = {
     appKey: string;
-    status: Set<string>;
+    status: Set<ActionBaseType<Actions>>;
     manifest?: AppManifest;
     config?: AppConfig<TConfig>;
+    settings?: AppSettings;
     modules?: AppScriptModule;
     instance?: AppModulesInstance<TModules>;
 };

package/dist/types/errors.d.ts

@@ -39,6 +39,26 @@ export declare class AppConfigError extends Error {
      */
     constructor(type: AppErrorType, message?: string, options?: ErrorOptions);
 }
+/**
+ * Represents an error that occurs while fetching application settings.
+ */
+export declare class AppSettingsError extends Error {
+    readonly type: AppErrorType;
+    /**
+     * Creates an instance of `AppSettingsError` based on the HTTP response status.
+     * @param response The HTTP response.
+     * @param options Additional error options.
+     * @returns An instance of `AppSettingsError` based on the HTTP response status.
+     */
+    static fromHttpResponse(response: Response, options?: ErrorOptions): AppSettingsError;
+    /**
+     * Creates an instance of `AppSettingsError`.
+     * @param type The type of the application error.
+     * @param message The error message.
+     * @param options Additional error options.
+     */
+    constructor(type: AppErrorType, message?: string, options?: ErrorOptions);
+}
 /**
  * Represents an error that occurs when loading the application script.
  */

package/dist/types/types.d.ts

@@ -15,6 +15,9 @@ export type AppEnv<TEnv extends ConfigEnvironment = ConfigEnvironment, TProps =
     props?: TProps;
 };
 export type ModuleDeps = [HttpModule, ServiceDiscoveryModule, EventModule];
+export interface AppSettings {
+    [key: string]: unknown;
+}
 export type AppType = 'standalone' | 'report' | 'launcher' | 'template';
 export type CurrentApp<TModules extends Array<AnyModule> = [], TEnv extends ConfigEnvironment = ConfigEnvironment> = IApp<TEnv, TModules> | null | undefined;
 type Nullable<T> = T | null | undefined;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "6.0.3";
+export declare const version = "6.1.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-module-app",
-  "version": "6.0.3",
+  "version": "6.1.0",
   "description": "",
   "main": "dist/esm/index.js",
   "exports": {
@@ -53,8 +53,10 @@
     "directory": "packages/modules/app"
   },
   "dependencies": {
+    "fast-deep-equal": "^3.1.3",
     "immer": "^9.0.16",
     "rxjs": "^7.8.1",
+    "uuid": "^11.0.3",
     "zod": "^3.23.8",
     "@equinor/fusion-observable": "^8.4.3",
     "@equinor/fusion-query": "^5.1.5"
@@ -64,8 +66,8 @@
     "@equinor/fusion-framework-module": "^4.3.5",
     "@equinor/fusion-framework-module-event": "^4.2.4",
     "@equinor/fusion-framework-module-msal": "^3.1.5",
-    "@equinor/fusion-framework-module-service-discovery": "^8.0.3",
-    "@equinor/fusion-framework-module-http": "^6.2.0"
+    "@equinor/fusion-framework-module-http": "^6.2.0",
+    "@equinor/fusion-framework-module-service-discovery": "^8.0.3"
   },
   "scripts": {
     "build": "tsc -b"

package/src/AppClient.ts

@@ -1,4 +1,4 @@
-import { catchError, map, Observable, ObservableInput } from 'rxjs';
+import { catchError, map, Observable, ObservableInput, tap } from 'rxjs';
 
 import { Query } from '@equinor/fusion-query';
 import { queryValue } from '@equinor/fusion-query/operators';
@@ -8,8 +8,8 @@ import { jsonSelector } from '@equinor/fusion-framework-module-http/selectors';
 
 import { ApiApplicationSchema } from './schemas';
 
-import type { AppConfig, AppManifest, ConfigEnvironment } from './types';
-import { AppConfigError, AppManifestError } from './errors';
+import type { AppConfig, AppManifest, AppSettings, ConfigEnvironment } from './types';
+import { AppConfigError, AppManifestError, AppSettingsError } from './errors';
 import { AppConfigSelector } from './AppClient.Selectors';
 
 export interface IAppClient extends Disposable {
@@ -30,6 +30,21 @@ export interface IAppClient extends Disposable {
         appKey: string;
         tag?: string;
     }) => ObservableInput<AppConfig<TType>>;
+
+    /**
+     * Fetch app settings by appKey
+     */
+    getAppSettings: (args: { appKey: string }) => ObservableInput<AppSettings>;
+
+    /**
+     * Set app settings by appKey
+     * @param args - Object with appKey and settings
+     * @returns ObservableInput<AppSettings>
+     */
+    updateAppSettings: (args: {
+        appKey: string;
+        settings: AppSettings;
+    }) => ObservableInput<AppSettings>;
 }
 
 /**
@@ -62,8 +77,12 @@ export class AppClient implements IAppClient {
     #manifest: Query<AppManifest, { appKey: string }>;
     #manifests: Query<AppManifest[], { filterByCurrentUser?: boolean } | undefined>;
     #config: Query<AppConfig, { appKey: string; tag?: string }>;
+    #settings: Query<AppSettings, { appKey: string; settings?: AppSettings }>;
+    #client: IHttpClient;
 
     constructor(client: IHttpClient) {
+        this.#client = client;
+
         const expire = 1 * 60 * 1000;
         this.#manifest = new Query<AppManifest, { appKey: string }>({
             client: {
@@ -90,8 +109,8 @@ export class AppClient implements IAppClient {
                             'Api-Version': '1.0',
                         },
                         selector: async (res: Response) => {
-                            const response = (await jsonSelector(res)) as { value: unknown[] };
-                            return ApplicationSchema.array().parse(response.value);
+                            const body = await res.json();
+                            return body;
                         },
                     });
                 },
@@ -114,7 +133,22 @@ export class AppClient implements IAppClient {
             key: (args) => JSON.stringify(args),
             expire,
         });
+
+        this.#settings = new Query<AppSettings, { appKey: string }>({
+            client: {
+                fn: ({ appKey }) => {
+                    return client.json<AppSettings>(`/persons/me/apps/${appKey}/settings`, {
+                        headers: {
+                            'Api-Version': '1.0',
+                        },
+                    });
+                },
+            },
+            key: (args) => args.appKey,
+            expire,
+        });
     }
+
     getAppManifest(args: { appKey: string }): Observable<AppManifest> {
         return this.#manifest.query(args).pipe(
             queryValue,
@@ -158,11 +192,56 @@ export class AppClient implements IAppClient {
         );
     }
 
+    getAppSettings(args: { appKey: string }): Observable<AppSettings> {
+        return this.#settings.query(args).pipe(
+            queryValue,
+            catchError((err) => {
+                /** extract cause, since error will be a `QueryError` */
+                const { cause } = err;
+                if (cause instanceof AppSettingsError) {
+                    throw cause;
+                }
+                if (cause instanceof HttpResponseError) {
+                    throw AppSettingsError.fromHttpResponse(cause.response, { cause });
+                }
+                throw new AppSettingsError('unknown', 'failed to load settings', { cause });
+            }),
+        );
+    }
+
+    updateAppSettings(args: { appKey: string; settings: AppSettings }): Observable<AppSettings> {
+        const { appKey, settings } = args;
+        return (
+            this.#client
+                // execute PUT request to update settings
+                .json$<AppSettings>(`/persons/me/apps/${appKey}/settings`, {
+                    method: 'PUT',
+                    body: settings,
+                    headers: {
+                        'Api-Version': '1.0',
+                    },
+                })
+                .pipe(
+                    tap((value) => {
+                        // update cache with new settings
+                        this.#settings.mutate(
+                            { appKey },
+                            {
+                                value,
+                                updated: Date.now(),
+                            },
+                        );
+                    }),
+                )
+        );
+    }
+
     [Symbol.dispose]() {
         console.warn('AppClient disposed');
         this.#manifest.complete();
         this.#manifests.complete();
         this.#config.complete();
+        this.#settings.complete();
     }
 }
 

package/src/AppModuleProvider.ts

@@ -12,7 +12,7 @@ import {
 import { ModuleType } from '@equinor/fusion-framework-module';
 import { EventModule } from '@equinor/fusion-framework-module-event';
 
-import type { AppConfig, AppManifest, ConfigEnvironment, CurrentApp } from './types';
+import type { AppConfig, AppManifest, AppSettings, ConfigEnvironment, CurrentApp } from './types';
 
 import { App, filterEmpty, IApp } from './app/App';
 import { AppModuleConfig } from './AppConfigurator';
@@ -122,6 +122,23 @@ export class AppModuleProvider {
         return from(this.#appClient.getAppConfig<TType>({ appKey, tag }));
     }
 
+    /**
+     * fetch user settings for an application
+     * @param appKey - application key
+     */
+    public getAppSettings(appKey: string): Observable<AppSettings> {
+        return from(this.#appClient.getAppSettings({ appKey }));
+    }
+
+    /**
+     * Put user settings for an application
+     * @param appKey - application key
+     * @param settings - The settings to add save
+     */
+    public updateAppSettings(appKey: string, settings: AppSettings): Observable<AppSettings> {
+        return from(this.#appClient.updateAppSettings({ appKey, settings }));
+    }
+
     /**
      * set the current application, will internally resolve manifest
      * @param appKey - application key