@geogirafe/lib-geoportal 1.2.0-dev.2873796427 → 1.2.0-dev.2889263072

package/api/apicontext.d.ts

@@ -46,8 +46,8 @@ export default class GirafeApiContext implements IGirafeContext {
     readonly themesManager: ThemesManager;
     readonly themesHelper: ThemesHelper;
     readonly permalinkManager: PermalinkManager;
-    readonly urlManager: UrlManager;
     readonly dragManager: DragManager;
+    readonly urlManager: UrlManager;
     readonly layerManager: LayerManager;
     readonly sessionManager: ApiSessionManager;
     readonly stateSerializer: StateSerializer;
@@ -72,6 +72,17 @@ export default class GirafeApiContext implements IGirafeContext {
     readonly themeFavoritesManager: ThemeFavoritesManager;
     readonly searchManager: SearchManager;
     readonly feedbackManager: FeedbackManager;
+    private readonly contextHelper;
     constructor();
     initialize(): Promise<void>;
+    /** The context can contains hook methods that will be called after each manager initialization.
+     * The hook method must be named with the property name + the "Hook" suffix.
+     * The hook method must be async and will be awaited
+     * For example, the methods themesManagerHook() will be called immediately after
+     * the call of themesManager.initializeSingleton().
+     * This allows specific initialization methods when defining custom contexts
+     * (for example for the apiContext, the mockContext, or any customContext)
+     */
+    protected configManagerHook(): Promise<void>;
+    protected stateManagerHook(): Promise<void>;
 }

package/api/apicontext.js

@@ -1,41 +1,6 @@
-// SPDX-License-Identifier: Apache-2.0
-import ApplicationLifeCycleManager from '../tools/app/lifecyclemanager.js';
-import AuthManager from '../tools/auth/authmanager.js';
-import DragManager from '../components/treeview/tools/dragmanager.js';
-import PluginManager from '../tools/auth/pluginmanager.js';
-import ConfigManager from '../tools/configuration/configmanager.js';
-import ErrorManager from '../tools/error/errormanager.js';
-import I18nManager from '../tools/i18n/i18nmanager.js';
-import LayerManager from '../tools/layers/layermanager.js';
-import SnapManager from '../tools/layers/snapmanager.js';
-import LocalFileManager from '../tools/localfile/localfilemanager.js';
-import LogManager from '../tools/logging/logmanager.js';
-import OfflineManager from '../tools/offline/offlinemanager.js';
-import OgcApiFeaturesManager from '../tools/ogcapi/ogcapifeaturesmanager.js';
-import OrderingManager from '../tools/ordering/orderingmanager.js';
-import ShareManager from '../tools/share/sharemanager.js';
-import StateSerializer from '../tools/share/stateserializer.js';
-import ComponentManager from '../tools/state/componentManager.js';
-import MapManager from '../tools/state/mapManager.js';
-import StateManager from '../tools/state/statemanager.js';
-import UserInteractionManager from '../tools/state/userInteractionManager.js';
-import CustomThemesManager from '../tools/themes/customthemesmanager.js';
-import ThemesHelper from '../tools/themes/themeshelper.js';
-import ThemesManager from '../tools/themes/themesmanager.js';
-import UserLayerManager from '../tools/themes/userlayermanager.js';
-import PermalinkManager from '../tools/url/permalinkmanager.js';
-import UrlManager from '../tools/url/urlmanager.js';
-import UserDataManager from '../tools/userdata/userdatamanager.js';
-import WfsManager from '../tools/wfs/wfsmanager.js';
-import WmsManager from '../tools/wms/wmsmanager.js';
-import WmtsManager from '../tools/wmts/wmtsmanager.js';
-import SelectionManager from '../tools/selection/selectionmanager.js';
 import ApiSessionManager from './apisessionmanager.js';
-import OnBoardingManager from '../tools/onboarding/onboardingmanager.js';
-import ThemeFavoritesManager from '../tools/themes/themefavoritesmanager.js';
-import SearchManager from '../tools/search/searchmanager.js';
-import FeedbackManager from '../tools/feedback/feedbackmanager.js';
 import { updateConfigPaths } from './apiutils.js';
+import ContextInitializationHelper from '../tools/context/contexthelper.js';
 export default class GirafeApiContext {
     userDataManager;
     configManager;
@@ -47,8 +12,8 @@ export default class GirafeApiContext {
     themesManager;
     themesHelper;
     permalinkManager;
-    urlManager;
     dragManager;
+    urlManager;
     layerManager;
     sessionManager;
     stateSerializer;
@@ -73,87 +38,30 @@ export default class GirafeApiContext {
     themeFavoritesManager;
     searchManager;
     feedbackManager;
+    contextHelper = new ContextInitializationHelper();
     constructor() {
-        this.componentManager = new ComponentManager(this);
-        this.userDataManager = new UserDataManager(this);
-        this.configManager = new ConfigManager(this);
-        this.logManager = new LogManager(this);
-        this.stateManager = new StateManager(this);
-        this.orderingManager = new OrderingManager(this);
-        this.applicationLifeCycleManager = new ApplicationLifeCycleManager(this);
-        this.mapManager = new MapManager(this);
-        this.offlineManager = new OfflineManager(this);
-        this.snapManager = new SnapManager(this);
-        this.authManager = new AuthManager(this);
-        this.pluginManager = new PluginManager(this);
-        this.i18nManager = new I18nManager(this);
-        this.userInteractionManager = new UserInteractionManager(this);
-        this.dragManager = new DragManager(this);
-        this.urlManager = new UrlManager(this);
-        this.permalinkManager = new PermalinkManager(this);
-        this.layerManager = new LayerManager(this);
-        this.userLayerManager = new UserLayerManager(this);
-        this.themesHelper = new ThemesHelper(this);
-        this.stateSerializer = new StateSerializer(this);
+        this.contextHelper.constructContext(this, ['sessionManager']);
         this.sessionManager = new ApiSessionManager(this);
-        this.shareManager = new ShareManager(this);
-        this.wfsManager = new WfsManager(this);
-        this.errorManager = new ErrorManager(this);
-        this.customThemesManager = new CustomThemesManager(this);
-        this.themesManager = new ThemesManager(this);
-        this.wmsManager = new WmsManager(this);
-        this.wmtsManager = new WmtsManager(this);
-        this.selectionManager = new SelectionManager(this);
-        this.localFileManager = new LocalFileManager(this);
-        this.ogcApiFeaturesManager = new OgcApiFeaturesManager(this);
-        this.onBoardingManager = new OnBoardingManager(this);
-        this.themeFavoritesManager = new ThemeFavoritesManager(this);
-        this.searchManager = new SearchManager(this);
-        this.feedbackManager = new FeedbackManager(this);
     }
     async initialize() {
-        // NOTE : This initialization order is important, because some singleton will need other ones !
-        this.componentManager.initializeSingleton();
-        this.userDataManager.initializeSingleton();
-        this.configManager.initializeSingleton();
-        await this.configManager.loadConfig();
+        await this.contextHelper.initializeContext(this);
+    }
+    /** The context can contains hook methods that will be called after each manager initialization.
+     * The hook method must be named with the property name + the "Hook" suffix.
+     * The hook method must be async and will be awaited
+     * For example, the methods themesManagerHook() will be called immediately after
+     * the call of themesManager.initializeSingleton().
+     * This allows specific initialization methods when defining custom contexts
+     * (for example for the apiContext, the mockContext, or any customContext)
+     */
+    async configManagerHook() {
+        await this.configManager.initializeSingleton();
         // For the API context, some configuraton options in the config file can be relative.
         // We have to convert them to absolute paths.
         updateConfigPaths(this.configManager.Config);
-        this.logManager.initializeSingleton();
-        this.logManager.initLogging();
-        this.stateManager.initializeSingleton();
+    }
+    async stateManagerHook() {
+        await this.stateManager.initializeSingleton();
         this.stateManager.state.interface.isApi = true;
-        this.orderingManager.initializeSingleton();
-        this.applicationLifeCycleManager.initializeSingleton();
-        this.mapManager.initializeSingleton();
-        this.offlineManager.initializeSingleton();
-        this.snapManager.initializeSingleton();
-        this.authManager.initializeSingleton();
-        this.pluginManager.initializeSingleton();
-        this.i18nManager.initializeSingleton();
-        this.userInteractionManager.initializeSingleton();
-        this.dragManager.initializeSingleton();
-        this.urlManager.initializeSingleton();
-        this.permalinkManager.initializeSingleton();
-        this.layerManager.initializeSingleton();
-        this.userLayerManager.initializeSingleton();
-        this.themesHelper.initializeSingleton();
-        this.stateSerializer.initializeSingleton();
-        this.sessionManager.initializeSingleton();
-        this.shareManager.initializeSingleton();
-        this.wfsManager.initializeSingleton();
-        this.errorManager.initializeSingleton();
-        this.customThemesManager.initializeSingleton();
-        this.themesManager.initializeSingleton();
-        this.wmsManager.initializeSingleton();
-        this.wmtsManager.initializeSingleton();
-        this.localFileManager.initializeSingleton();
-        this.selectionManager.initializeSingleton();
-        this.ogcApiFeaturesManager.initializeSingleton();
-        this.onBoardingManager.initializeSingleton();
-        this.themeFavoritesManager.initializeSingleton();
-        this.searchManager.initializeSingleton();
-        this.feedbackManager.initializeSingleton();
     }
 }

package/api/apisessionmanager.d.ts

@@ -1,7 +1,7 @@
 import GirafeSingleton from '../base/GirafeSingleton.js';
 import ISessionManager from '../tools/share/isessionmanager.js';
 declare class ApiSessionManager extends GirafeSingleton implements ISessionManager {
-    initializeSingleton(): void;
+    initializeSingleton(): Promise<void>;
     beginSession(): void;
     saveStateToSession(): void;
     hasState(): boolean;

package/api/apisessionmanager.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import GirafeSingleton from '../base/GirafeSingleton.js';
 class ApiSessionManager extends GirafeSingleton {
-    initializeSingleton() {
+    async initializeSingleton() {
         /* For the API: Do Nothing */
     }
     beginSession() {

package/base/GirafeSingleton.d.ts

@@ -2,7 +2,7 @@ import IGirafeContext from '../tools/context/icontext.js';
 declare class GirafeSingleton {
     protected readonly context: IGirafeContext;
     constructor(context: IGirafeContext);
-    initializeSingleton(): void;
+    initializeSingleton(): Promise<void>;
     protected isNullOrUndefinedOrBlank(val: unknown): val is "" | null | undefined;
 }
 export default GirafeSingleton;

package/base/GirafeSingleton.js

@@ -4,7 +4,7 @@ class GirafeSingleton {
     constructor(context) {
         this.context = context;
     }
-    initializeSingleton() {
+    async initializeSingleton() {
         /*
          * This method does nothing by default, but will be called by the context when creating the singleton
          * (This prevent overriding the constructor in every songleton and creating a strong dependency to the context object)

package/components/navigation/component.d.ts

@@ -15,8 +15,8 @@ declare class NavigationComponent extends GirafeHTMLElement {
     render(): void;
     addBookmark(): Promise<void>;
     removeBookmark(bookmark: Bookmark): Promise<void>;
-    saveBookmarks(): void;
-    loadBookmarks(): void;
+    private saveBookmarks;
+    private loadBookmarks;
     registerEvents(): void;
     onPositionChanged(position: MapPosition): void;
     navigateBack(): void;

package/components/navigation/component.js

@@ -36,7 +36,7 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
         if (name) {
             const bookmark = new Bookmark(name, this.state.position);
             this.bookmarks.push(bookmark);
-            this.saveBookmarks();
+            await this.saveBookmarks();
             super.render();
             super.girafeTranslate();
         }
@@ -48,17 +48,17 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
             if (index >= 0) {
                 this.bookmarks.splice(index, 1);
             }
-            this.saveBookmarks();
+            await this.saveBookmarks();
             super.render();
             super.girafeTranslate();
         }
     }
-    saveBookmarks() {
-        this.context.userDataManager.saveUserData(this.storagePath, this.bookmarks);
+    async saveBookmarks() {
+        await this.context.userDataManager.saveUserData(this.storagePath, this.bookmarks);
     }
-    loadBookmarks() {
+    async loadBookmarks() {
         this.bookmarks = [];
-        const storedBookmarks = this.context.userDataManager.getUserData(this.storagePath);
+        const storedBookmarks = (await this.context.userDataManager.getUserData(this.storagePath));
         if (storedBookmarks) {
             for (const bookmark of storedBookmarks) {
                 try {

package/components/news/news-button/component.d.ts

@@ -7,7 +7,6 @@ declare class NewsButtonComponent extends GirafeHTMLElement {
     warn: boolean;
     constructor();
     setWarn(): void;
-    loadLastViewDate(): void;
     getIcon(): "icons/bell-warn.svg" | "icons/bell.svg";
     connectedCallback(): void;
 }

package/components/news/news-button/component.js

@@ -26,12 +26,6 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
         }
         super.render();
     }
-    loadLastViewDate() {
-        const lastViewDate = this.context.userDataManager.getUserData('lastViewDate');
-        if (lastViewDate) {
-            this.context.stateManager.state.news.lastViewDate = lastViewDate;
-        }
-    }
     getIcon() {
         const icon = this.warn ? 'icons/bell-warn.svg' : 'icons/bell.svg';
         return icon;

package/components/news/news-panel/component.d.ts

@@ -10,8 +10,8 @@ declare class NewsPanelComponent extends GirafeHTMLElement implements IGirafePan
     panelTogglePath: string;
     entries: FeedEntry[];
     constructor();
-    saveLastViewDate(): void;
-    loadLastViewDate(): void;
+    saveLastViewDate(): Promise<void>;
+    private loadLastViewDate;
     togglePanel(visible: boolean): void;
     render(): void;
     private initializeNewsState;

package/components/news/news-panel/component.js

@@ -22,13 +22,13 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
     constructor() {
         super('news-panel');
     }
-    saveLastViewDate() {
+    async saveLastViewDate() {
         const currentTimestamp = Date.now();
-        this.context.userDataManager.saveUserData('lastViewDate', currentTimestamp);
+        await this.context.userDataManager.saveUserData('lastViewDate', currentTimestamp);
         this.context.stateManager.state.news.lastViewDate = currentTimestamp;
     }
-    loadLastViewDate() {
-        const raw = this.context.userDataManager.getUserData('lastViewDate');
+    async loadLastViewDate() {
+        const raw = await this.context.userDataManager.getUserData('lastViewDate');
         const lastViewDate = Number(raw);
         this.context.stateManager.state.news.lastViewDate = Number.isFinite(lastViewDate) ? lastViewDate : 0;
     }
@@ -52,7 +52,7 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
         if (!this.context.configManager.Config.news) {
             return;
         }
-        this.loadLastViewDate();
+        await this.loadLastViewDate();
         const urls = this.context.configManager.Config.news.urls;
         this.entries = await loadFeeds(urls);
         // Update state manager

package/components/themes/component.d.ts

@@ -25,7 +25,7 @@ declare class ThemeComponent extends GirafeHTMLElement {
     onThemeChanged(theme: ThemeLayer | CustomTheme): void;
     isThemeActive(theme: ThemeLayer | CustomTheme): boolean;
     isThemeFavorite(theme: ThemeLayer | CustomTheme): boolean;
-    onThemeFavoriteChanged(theme: ThemeLayer | CustomTheme, e: Event): void;
+    onThemeFavoriteChanged(theme: ThemeLayer | CustomTheme, e: Event): Promise<void>;
     isThemeTypeActive(themeType: ThemeType): boolean;
     isCustomTheme(theme: ThemeLayer | CustomTheme): theme is CustomTheme;
     onCustomThemeChanged(customTheme: CustomTheme): void;

package/components/themes/component.js

@@ -117,10 +117,10 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
     isThemeFavorite(theme) {
         return this.context.themeFavoritesManager.isThemeInFavorites(theme);
     }
-    onThemeFavoriteChanged(theme, e) {
+    async onThemeFavoriteChanged(theme, e) {
         e.preventDefault();
         e.stopPropagation();
-        this.context.themeFavoritesManager.addOrRemoveThemeFromFavorites(theme);
+        await this.context.themeFavoritesManager.addOrRemoveThemeFromFavorites(theme);
         this.render();
     }
     isThemeTypeActive(themeType) {
@@ -136,7 +136,7 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
     async onAddCustomTheme() {
         const themeName = await window.gPrompt('Enter a name for your custom theme', 'Create custom theme', 'Enter a name...');
         if (themeName !== false && themeName.trim().length > 0) {
-            this.context.customThemesManager.addTheme(themeName, this.state.layers.layersList);
+            await this.context.customThemesManager.addTheme(themeName, this.state.layers.layersList);
             this.render();
         }
     }
@@ -144,7 +144,7 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
         e.stopPropagation();
         const confirm = await window.gConfirm('Do you want to delete this theme?', 'Delete Theme');
         if (confirm) {
-            this.context.customThemesManager.deleteTheme(customTheme);
+            await this.context.customThemesManager.deleteTheme(customTheme);
             this.render();
         }
     }

package/components/userpreferences/component.d.ts

@@ -59,7 +59,7 @@ export default class UserPreferencesComponent extends GirafeHTMLElement implemen
     /**
      Update state and local storage with new value
      */
-    changePreference(preferenceKey: string, newValue: unknown): void;
+    changePreference(preferenceKey: string, newValue: unknown): Promise<void>;
     /**
      Update the config object with the new value
      */

package/components/userpreferences/component.js

@@ -272,12 +272,12 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
     /**
      Update state and local storage with new value
      */
-    changePreference(preferenceKey, newValue) {
+    async changePreference(preferenceKey, newValue) {
         if (this.preferences[preferenceKey]) {
             this.preferences[preferenceKey].currentValue = newValue;
             this.updatePreferenceInConfig(preferenceKey);
             this.updatePreferenceInState(preferenceKey);
-            this.updatePreferenceInStorage(preferenceKey);
+            await this.updatePreferenceInStorage(preferenceKey);
             this.refreshRender();
         }
     }
@@ -300,10 +300,10 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
     /**
      Save the user preference as a config override in user data storage
      */
-    updatePreferenceInStorage(preferenceKey) {
+    async updatePreferenceInStorage(preferenceKey) {
         const preference = this.preferences[preferenceKey];
         // Values are saved under 'configOverrides' in the same structure as in the config
-        this.context.userDataManager.saveUserData(`${this.storagePath}.${preference.configPath}`, preference.currentValue);
+        await this.context.userDataManager.saveUserData(`${this.storagePath}.${preference.configPath}`, preference.currentValue);
     }
     /**
      * Reset user preferences back to defaults. This will delete the configOverrides object in storage and set the
@@ -312,11 +312,11 @@ ${this.htmlUnsafe(this.feedbackTemplateHtml ?? '')}`;
     async onResetAll() {
         const confirm = await window.gConfirm('Reset user preferences back to default values?', 'Reset preferences');
         if (confirm) {
-            this.resetAll();
+            await this.resetAll();
         }
     }
-    resetAll() {
-        this.context.userDataManager.deleteUserData(this.storagePath);
+    async resetAll() {
+        await this.context.userDataManager.deleteUserData(this.storagePath);
         for (const preferenceKey in this.preferences) {
             this.preferences[preferenceKey].currentValue = this.context.configManager.getDefaultConfigValue(this.preferences[preferenceKey].configPath);
             this.updatePreferenceInState(preferenceKey);

package/package.json

@@ -5,7 +5,7 @@
     "name": "GeoGirafe PSC",
     "url": "https://doc.geogirafe.org"
   },
-  "version": "1.2.0-dev.2873796427",
+  "version": "1.2.0-dev.2889263072",
   "type": "module",
   "engines": {
     "node": ">=20.19.0"

package/templates/public/about.json

@@ -1 +1 @@
-{"version":"1.2.0-dev.2873796427", "build":"2873796427", "date":"23/09/2026"}
+{"version":"1.2.0-dev.2889263072", "build":"2889263072", "date":"28/09/2026"}

package/tools/app/lifecyclemanager.d.ts

@@ -1,7 +1,7 @@
 import GirafeSingleton from '../../base/GirafeSingleton.js';
 export default class ApplicationLifeCycleManager extends GirafeSingleton {
     private get state();
-    initializeSingleton(): void;
+    initializeSingleton(): Promise<void>;
     private log;
     /**
      * For the application to be ready to load the themes and to deserialize the shared state or the session,

package/tools/app/lifecyclemanager.js

@@ -4,7 +4,7 @@ export default class ApplicationLifeCycleManager extends GirafeSingleton {
     get state() {
         return this.context.stateManager.state;
     }
-    initializeSingleton() {
+    async initializeSingleton() {
         this.context.stateManager.subscribe('themes.isLoaded', (_, isThemesLoaded) => {
             this.log(isThemesLoaded, 'Themes are loaded');
             this.checkApplicationReady();

package/tools/auth/abstractconnectmanager.js

@@ -60,10 +60,10 @@ export default class AbstractConnectManager {
         return url.toString();
     }
     loadFromLocalStorage(path) {
-        return this.context.userDataManager.getUserData(`${this.storagePath}.${path}`, true) ?? '';
+        return this.context.userDataManager.getFromLocalStorage(`${this.storagePath}.${path}`) ?? '';
     }
     saveToLocalStorage(path, value) {
-        return this.context.userDataManager.saveUserData(`${this.storagePath}.${path}`, value, true);
+        this.context.userDataManager.saveToLocalStorage(`${this.storagePath}.${path}`, value);
     }
     resetUrl() {
         const url = new URL(this.context.urlManager.getBaseUrlPath());

package/tools/auth/authmanager.d.ts

@@ -6,7 +6,7 @@ export default class AuthManager extends GirafeSingleton {
     private readonly gmfManager;
     private get state();
     constructor(context: IGirafeContext);
-    initializeSingleton(): void;
+    initializeSingleton(): Promise<void>;
     initialize(sw: ServiceWorker | null): Promise<void>;
     private initializeOAuth;
     private initializeGmfAuth;

package/tools/auth/authmanager.js

@@ -15,7 +15,7 @@ export default class AuthManager extends GirafeSingleton {
         super(context);
         this.gmfManager = new GMFManager(this.context);
     }
-    initializeSingleton() {
+    async initializeSingleton() {
         this.context.stateManager.subscribe('oauth.status', () => this.loginStateChanged());
         this.context.stateManager.subscribe('oauth.tokens', () => this.tokensChanged());
     }

package/tools/auth/pluginmanager.d.ts

@@ -1,6 +1,6 @@
 import GirafeSingleton from '../../base/GirafeSingleton.js';
 declare class PluginManager extends GirafeSingleton {
-    initializeSingleton(): void;
+    initializeSingleton(): Promise<void>;
     filterPlugins(dom: DocumentFragment | Document): void;
     private filterPluginFromConfig;
     private filterPlugin;

package/tools/auth/pluginmanager.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import GirafeSingleton from '../../base/GirafeSingleton.js';
 class PluginManager extends GirafeSingleton {
-    initializeSingleton() {
+    async initializeSingleton() {
         this.context.stateManager.subscribe('oauth.userInfo', () => this.filterPlugins(document));
         this.filterPlugins(document);
     }

package/tools/configuration/configmanager.d.ts

@@ -10,7 +10,8 @@ declare class ConfigManager extends GirafeSingleton {
     constructor(context: IGirafeContext);
     get Config(): GirafeConfig;
     private getConfigUrls;
-    loadConfig(): Promise<GirafeConfig>;
+    initializeSingleton(): Promise<void>;
+    private loadConfig;
     private doLoadConfig;
     /**
      * Merges two configuration objects recursively.
@@ -20,7 +21,7 @@ declare class ConfigManager extends GirafeSingleton {
      * Retrieves saved configuration overrides based on the user data source.
      * @param userDataSource The source of user data.
      */
-    private getConfigOverrides;
+    private loadConfigOverrides;
     /**
      * Retrieves the original (default) configuration value before applying overrides.
      * @param path The path to the configuration property.

package/tools/configuration/configmanager.js

@@ -42,6 +42,9 @@ class ConfigManager extends GirafeSingleton {
         }
         return configUrls;
     }
+    async initializeSingleton() {
+        await this.loadConfig();
+    }
     async loadConfig() {
         if (this.loadingPromise) {
             // There's already a promise for loading the configuration
@@ -50,7 +53,7 @@ class ConfigManager extends GirafeSingleton {
         }
         if (this.config) {
             // Config was already loaded.
-            return Promise.resolve(this.config);
+            return this.config;
         }
         this.loadingPromise = this.doLoadConfig();
         return this.loadingPromise;
@@ -77,7 +80,7 @@ class ConfigManager extends GirafeSingleton {
         // Create a backup of the default config before applying overrides
         this.defaultConfig = new GirafeConfig(structuredClone(jsonConfig));
         // Load config overrides and merge them with the default config
-        const configOverrides = this.getConfigOverrides(this.defaultConfig.userdata.source);
+        const configOverrides = await this.loadConfigOverrides(this.defaultConfig);
         jsonConfig = this.mergeConfigs(jsonConfig, configOverrides);
         this.config = new GirafeConfig(jsonConfig);
         console.log('Application Configuration loaded.');
@@ -93,10 +96,11 @@ class ConfigManager extends GirafeSingleton {
      * Retrieves saved configuration overrides based on the user data source.
      * @param userDataSource The source of user data.
      */
-    getConfigOverrides(userDataSource) {
+    async loadConfigOverrides(config) {
         // Set the user data source first before requesting config overrides from the userDataManager
-        this.context.userDataManager.setSource(userDataSource);
-        return this.context.userDataManager.getUserData(this.storagePathForOverrides) || {};
+        this.context.userDataManager.initializeFromConfig(config.userdata);
+        const configOverrides = await this.context.userDataManager.getUserData(this.storagePathForOverrides);
+        return configOverrides;
     }
     /**
      * Retrieves the original (default) configuration value before applying overrides.

package/tools/configuration/girafeconfig.d.ts

@@ -2,6 +2,11 @@ export declare enum HighlightMode {
     HighlightAll = "highlight-all",
     HighlightPerLayer = "highlight-per-layer"
 }
+export type UserDataConfig = {
+    source: 'localStorage' | 'server';
+    getUrl?: string;
+    postUrl?: string;
+};
 import { Config as SanitizeConfig } from 'dompurify';
 import { LayoutType } from '../state/layout.js';
 declare class GirafeConfig {
@@ -243,11 +248,7 @@ declare class GirafeConfig {
             refererPolicy: ReferrerPolicy;
         };
     };
-    userdata: {
-        source: 'localStorage' | 'server';
-        getUrl: string | undefined;
-        postUrl: string | undefined;
-    };
+    userdata: UserDataConfig;
     contact?: {
         url: string;
         reasons: string[];

package/tools/configuration/girafeconfig.js

@@ -466,6 +466,9 @@ class GirafeConfig {
         const defaultConfig = {
             source: 'localStorage'
         };
+        if (config.userdata?.source === 'server' && (!config.userdata?.getUrl || !config.userdata?.postUrl)) {
+            throw new Error(`Configuration userdata.getUrl or userdata.postUrl is missing. See https://doc.geogirafe.org/docs/configuration.`);
+        }
         return {
             ...defaultConfig,
             ...config.userdata

package/tools/context/context.d.ts

@@ -72,6 +72,7 @@ export default class GirafeContext implements IGirafeContext {
     readonly themeFavoritesManager: ThemeFavoritesManager;
     readonly searchManager: SearchManager;
     readonly feedbackManager: FeedbackManager;
+    private readonly contextHelper;
     constructor();
     initialize(): Promise<void>;
 }