@rxap/config 19.2.0-dev.2 → 19.2.0-dev.3

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [19.2.0-dev.3](https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.2...@rxap/config@19.2.0-dev.3) (2026-01-19)
+
+### Features
+
+- **config:** add `strategy` option and FIFO handling for dynamic config loading ([7534069](https://gitlab.com/rxap/packages/commit/7534069a897493c402d3164d6bb7df7b3f1dc9dd))
+
 # [19.2.0-dev.2](https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.1...@rxap/config@19.2.0-dev.2) (2025-10-28)
 
 ### Features

package/compodoc/changelog.html

@@ -85,6 +85,11 @@
 <h1>Change Log</h1>
 <p>All notable changes to this project will be documented in this file.
 See <a href="https://conventionalcommits.org">Conventional Commits</a> for commit guidelines.</p>
+<h1><a href="https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.2...@rxap/config@19.2.0-dev.3">19.2.0-dev.3</a> (2026-01-19)</h1>
+<h3>Features</h3>
+<ul>
+<li><strong>config:</strong> add <code>strategy</code> option and FIFO handling for dynamic config loading (<a href="https://gitlab.com/rxap/packages/commit/7534069a897493c402d3164d6bb7df7b3f1dc9dd">7534069</a>)</li>
+</ul>
 <h1><a href="https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.1...@rxap/config@19.2.0-dev.2">19.2.0-dev.2</a> (2025-10-28)</h1>
 <h3>Features</h3>
 <ul>

package/compodoc/dependencies.html

@@ -119,7 +119,7 @@
         <li>
             <b>@rxap/environment</b> : ^19.0.4</li>
         <li>
-            <b>@rxap/utilities</b> : ^16.5.0-dev.0</li>
+            <b>@rxap/utilities</b> : ^16.5.0-dev.1</li>
         <li>
             <b>rxjs</b> : ^7.8.1</li>
     </ul>

package/compodoc/injectables/ConfigService.html

@@ -260,7 +260,7 @@
                 </tr>
                         <tr>
                             <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="79" class="link-to-prism">src/lib/config.service.ts:79</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="86" class="link-to-prism">src/lib/config.service.ts:86</a></div>
                             </td>
                         </tr>
 
@@ -325,8 +325,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="430"
-                                    class="link-to-prism">src/lib/config.service.ts:430</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="504"
+                                    class="link-to-prism">src/lib/config.service.ts:504</a></div>
                         </td>
                     </tr>
 
@@ -364,8 +364,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="434"
-                                    class="link-to-prism">src/lib/config.service.ts:434</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="508"
+                                    class="link-to-prism">src/lib/config.service.ts:508</a></div>
                         </td>
                     </tr>
 
@@ -441,8 +441,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="435"
-                                    class="link-to-prism">src/lib/config.service.ts:435</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="509"
+                                    class="link-to-prism">src/lib/config.service.ts:509</a></div>
                         </td>
                     </tr>
 
@@ -530,8 +530,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="436"
-                                    class="link-to-prism">src/lib/config.service.ts:436</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="510"
+                                    class="link-to-prism">src/lib/config.service.ts:510</a></div>
                         </td>
                     </tr>
 
@@ -619,8 +619,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="368"
-                                    class="link-to-prism">src/lib/config.service.ts:368</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="442"
+                                    class="link-to-prism">src/lib/config.service.ts:442</a></div>
                         </td>
                     </tr>
 
@@ -721,8 +721,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="374"
-                                    class="link-to-prism">src/lib/config.service.ts:374</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="448"
+                                    class="link-to-prism">src/lib/config.service.ts:448</a></div>
                         </td>
                     </tr>
 
@@ -831,8 +831,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="440"
-                                    class="link-to-prism">src/lib/config.service.ts:440</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="514"
+                                    class="link-to-prism">src/lib/config.service.ts:514</a></div>
                         </td>
                     </tr>
 
@@ -908,8 +908,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="441"
-                                    class="link-to-prism">src/lib/config.service.ts:441</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="515"
+                                    class="link-to-prism">src/lib/config.service.ts:515</a></div>
                         </td>
                     </tr>
 
@@ -997,8 +997,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="442"
-                                    class="link-to-prism">src/lib/config.service.ts:442</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="516"
+                                    class="link-to-prism">src/lib/config.service.ts:516</a></div>
                         </td>
                     </tr>
 
@@ -1087,8 +1087,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="99"
-                                    class="link-to-prism">src/lib/config.service.ts:99</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="106"
+                                    class="link-to-prism">src/lib/config.service.ts:106</a></div>
                         </td>
                     </tr>
 
@@ -1173,8 +1173,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="426"
-                                    class="link-to-prism">src/lib/config.service.ts:426</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="500"
+                                    class="link-to-prism">src/lib/config.service.ts:500</a></div>
                         </td>
                     </tr>
 
@@ -1243,8 +1243,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="349"
-                                    class="link-to-prism">src/lib/config.service.ts:349</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="423"
+                                    class="link-to-prism">src/lib/config.service.ts:423</a></div>
                         </td>
                     </tr>
 
@@ -1353,7 +1353,7 @@
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="79" class="link-to-prism">src/lib/config.service.ts:79</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="86" class="link-to-prism">src/lib/config.service.ts:86</a></div>
                         </td>
                     </tr>
 
@@ -1385,7 +1385,7 @@
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="58" class="link-to-prism">src/lib/config.service.ts:58</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="65" class="link-to-prism">src/lib/config.service.ts:65</a></div>
                         </td>
                     </tr>
 
@@ -1417,7 +1417,7 @@
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="65" class="link-to-prism">src/lib/config.service.ts:65</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="72" class="link-to-prism">src/lib/config.service.ts:72</a></div>
                         </td>
                     </tr>
 
@@ -1457,7 +1457,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="73" class="link-to-prism">src/lib/config.service.ts:73</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="80" class="link-to-prism">src/lib/config.service.ts:80</a></div>
                         </td>
                     </tr>
 
@@ -1483,7 +1483,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="52" class="link-to-prism">src/lib/config.service.ts:52</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="59" class="link-to-prism">src/lib/config.service.ts:59</a></div>
                         </td>
                     </tr>
 
@@ -1515,7 +1515,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="55" class="link-to-prism">src/lib/config.service.ts:55</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="62" class="link-to-prism">src/lib/config.service.ts:62</a></div>
                         </td>
                     </tr>
 
@@ -1541,7 +1541,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="53" class="link-to-prism">src/lib/config.service.ts:53</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="60" class="link-to-prism">src/lib/config.service.ts:60</a></div>
                         </td>
                     </tr>
 
@@ -1573,7 +1573,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="56" class="link-to-prism">src/lib/config.service.ts:56</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="63" class="link-to-prism">src/lib/config.service.ts:63</a></div>
                         </td>
                     </tr>
 
@@ -1605,7 +1605,7 @@ the Urls array.</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="71" class="link-to-prism">src/lib/config.service.ts:71</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="78" class="link-to-prism">src/lib/config.service.ts:78</a></div>
                         </td>
                     </tr>
 
@@ -1649,7 +1649,7 @@ value form the Defaults values or dynamic config files</p>
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="78" class="link-to-prism">src/lib/config.service.ts:78</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="85" class="link-to-prism">src/lib/config.service.ts:85</a></div>
                         </td>
                     </tr>
 
@@ -1685,8 +1685,14 @@ import {
 
 export type AnySchema &#x3D; { validateAsync: (...args: any[]) &#x3D;&gt; any };
 
+export enum ConfigLoadingStrategy {
+  DEFAULT &#x3D; &#x27;default&#x27;,
+  FIFO &#x3D; &#x27;fifo&#x27;,
+}
+
 export interface ConfigLoadOptions {
   fromUrlParam?: string | boolean;
+  fromUrls?: boolean;
   fromLocalStorage?: boolean;
   schema?: AnySchema;
   url?: string | string[] | ((environment: Environment) &#x3D;&gt; string | string[]);
@@ -1706,6 +1712,7 @@ export interface ConfigLoadOptions {
   fromCid?: string;
   fetchCidContent?: (cid: string, path?: string) &#x3D;&gt; Promise&lt;Blob | null&gt;;
   dnsServers?: string[];
+  strategy?: ConfigLoadingStrategy;
 }
 
 @Injectable({
@@ -1774,65 +1781,132 @@ export class ConfigService&lt;Config extends Record&lt;string, any&gt; &#x3D; Re
         options.fromUrlParam &#x3D; environment.config.fromUrlParam;
         options.fromLocalStorage &#x3D; environment.config.fromLocalStorage;
         options.schema &#x3D; environment.config.schema;
+        options.strategy &#x3D; environment.config.strategy as ConfigLoadingStrategy ?? options.strategy;
       }
     }
 
     config &#x3D; deepMerge(config, options?.static ?? {});
+    let done &#x3D; false;
 
-    const urls &#x3D; (options?.url ? coerceArray(options.url) : ConfigService.Urls).map(url &#x3D;&gt; {
-      if (typeof url &#x3D;&#x3D;&#x3D; &#x27;function&#x27;) {
-        if (!environment) {
-          throw new Error(&#x27;environment is required when url is a function&#x27;);
+    if (!done &amp;&amp; options?.fromUrls !&#x3D;&#x3D; false) {
+      try {
+        config &#x3D; deepMerge(config, await this.loadConfigFromUrls(options, environment));
+        if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          done &#x3D; true;
+        }
+      } catch (error: any) {
+        if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          console.error(&#x27;Could not load config from urls&#x27;, error);
+          throw error;
+        } else {
+          console.warn(&#x27;Could not load config from urls: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
         }
-        return coerceArray(url(environment));
       }
-      return coerceArray(url);
-    }).flat();
+    }
 
-    for (const url of urls) {
-      const loadedConfig &#x3D; await this.loadConfig(url, true, options?.schema);
-      const match &#x3D; url.match(/config\.([a-zA-Z0-9.\-_]+)\.json/);
-      if (match) {
-        SetToObject(config, match[1], loadedConfig);
-      } else {
-        config &#x3D; deepMerge(config, loadedConfig);
+    if (!done &amp;&amp; options?.fromLocalStorage !&#x3D;&#x3D; false) {
+      try {
+        config &#x3D; deepMerge(config, this.loadConfigFromLocalStorage(options));
+        if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          done &#x3D; true;
+        }
+      } catch (error: any) {
+        if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          console.error(&#x27;Could not load config from local storage&#x27;, error);
+          throw error;
+        } else {
+          console.warn(&#x27;Could not load config from local storage: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
+        }
       }
     }
 
-    config &#x3D; deepMerge(config, this.Overwrites);
-
-    if (options?.fromLocalStorage !&#x3D;&#x3D; false) {
-
-      const localConfig &#x3D; localStorage.getItem(ConfigService.LocalStorageKey);
-
-      if (localConfig) {
-        try {
-          config &#x3D; deepMerge(config, JSON.parse(localConfig));
-        } catch (e: any) {
-          console.error(&#x27;local config could not be parsed&#x27;);
+    if (!done &amp;&amp; options?.fromUrlParam) {
+      try {
+        config &#x3D; deepMerge(config, this.loadConfigFromUrlParam(options as any));
+        if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          done &#x3D; true;
+        }
+      } catch (error: any) {
+        if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          console.error(&#x27;Could not load config from url param&#x27;, error);
+          throw error;
+        } else {
+          console.warn(&#x27;Could not load config from url param: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
         }
       }
-
     }
 
-    if (options?.fromUrlParam) {
-      const param &#x3D; typeof options.fromUrlParam &#x3D;&#x3D;&#x3D; &#x27;string&#x27; ? options.fromUrlParam : &#x27;config&#x27;;
-      config &#x3D; deepMerge(config, this.LoadConfigDefaultFromUrlParam(param));
+    if (!done &amp;&amp; options?.fromDns) {
+      await this.loadConfigFromDns(options as any);
     }
 
-    if (options?.fromDns) {
-      await this.loadConfigFromDns(options as any);
+    if (!done &amp;&amp; options?.fromCid) {
+      try {
+        config &#x3D; deepMerge(config, await this.loadConfigFromCid(options as any));
+        if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          done &#x3D; true;
+        }
+      } catch (error: any) {
+        if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
+          console.error(&#x27;Could not load config from cid&#x27;, error);
+          throw error;
+        } else {
+          console.warn(&#x27;Could not load config from cid: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
+        }
+      }
     }
 
-    if (options?.fromCid) {
-      config &#x3D; deepMerge(config, await this.loadConfigFromCid(options as any));
+    if (!done) {
+      console.warn(&#x27;No config loading strategy succeeded. Using default config.&#x27;);
     }
 
+    config &#x3D; deepMerge(config, this.Overwrites);
+
     console.debug(&#x27;app config&#x27;, config);
 
     this.Config &#x3D; config;
   }
 
+  private static loadConfigFromUrlParam(options: ConfigLoadOptions &amp; { fromUrlParam: string | true }) {
+    const param &#x3D; typeof options.fromUrlParam &#x3D;&#x3D;&#x3D; &#x27;string&#x27; ? options.fromUrlParam : &#x27;config&#x27;;
+    return this.LoadConfigDefaultFromUrlParam(param);
+  }
+
+  private static loadConfigFromLocalStorage(options: ConfigLoadOptions) {
+    const localConfig &#x3D; localStorage.getItem(ConfigService.LocalStorageKey);
+    if (localConfig) {
+      return JSON.parse(localConfig);
+    } else {
+      return {};
+    }
+  }
+
+  private static async loadConfigFromUrls(options: ConfigLoadOptions, environment?: Environment) {
+    let config: any &#x3D; {};
+    const urls &#x3D; (
+      options?.url ? coerceArray(options.url) : ConfigService.Urls
+    ).map(url &#x3D;&gt; {
+      if (typeof url &#x3D;&#x3D;&#x3D; &#x27;function&#x27;) {
+        if (!environment) {
+          throw new Error(&#x27;environment is required when url is a function&#x27;);
+        }
+        return coerceArray(url(environment));
+      }
+      return coerceArray(url);
+    }).flat();
+
+    for (const url of urls) {
+      const loadedConfig &#x3D; await this.loadConfig(url, true, options?.schema);
+      const match &#x3D; url.match(/config\.([a-zA-Z0-9.\-_]+)\.json/);
+      if (match) {
+        SetToObject(config, match[1], loadedConfig);
+      } else {
+        config &#x3D; deepMerge(config, loadedConfig);
+      }
+    }
+    return config;
+  }
+
   private static async loadConfigFromCid(options: ConfigLoadOptions &amp; { fromCid: string | boolean }) {
     console.debug(&#x27;Loading config from CID: &#x27;, options.fromCid);
     try {