@rxap/config 19.2.0-dev.3 → 19.3.0-dev.0

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [19.3.0-dev.0](https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0...@rxap/config@19.3.0-dev.0) (2026-02-09)
+
+### Features
+
+- **config:** add configurable loading order for config sources ([6aac03b](https://gitlab.com/rxap/packages/commit/6aac03bec5dfc5b8c162f424b90fdd64bfc3899e))
+
+# [19.2.0](https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.3...@rxap/config@19.2.0) (2026-01-23)
+
+**Note:** Version bump only for package @rxap/config
+
 # [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

package/compodoc/changelog.html

@@ -85,6 +85,13 @@
 <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...@rxap/config@19.3.0-dev.0">19.3.0-dev.0</a> (2026-02-09)</h1>
+<h3>Features</h3>
+<ul>
+<li><strong>config:</strong> add configurable loading order for config sources (<a href="https://gitlab.com/rxap/packages/commit/6aac03bec5dfc5b8c162f424b90fdd64bfc3899e">6aac03b</a>)</li>
+</ul>
+<h1><a href="https://gitlab.com/rxap/packages/compare/@rxap/config@19.2.0-dev.3...@rxap/config@19.2.0">19.2.0</a> (2026-01-23)</h1>
+<p><strong>Note:</strong> Version bump only for package @rxap/config</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>

package/compodoc/dependencies.html

@@ -117,9 +117,9 @@
         <li>
             <b>@angular/core</b> : ^19.2.1</li>
         <li>
-            <b>@rxap/environment</b> : ^19.0.4</li>
+            <b>@rxap/environment</b> : ^19.1.0</li>
         <li>
-            <b>@rxap/utilities</b> : ^16.5.0-dev.1</li>
+            <b>@rxap/utilities</b> : ^16.5.1-dev.0</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="86" class="link-to-prism">src/lib/config.service.ts:86</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="101" class="link-to-prism">src/lib/config.service.ts:101</a></div>
                             </td>
                         </tr>
 
@@ -325,8 +325,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="504"
-                                    class="link-to-prism">src/lib/config.service.ts:504</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="547"
+                                    class="link-to-prism">src/lib/config.service.ts:547</a></div>
                         </td>
                     </tr>
 
@@ -364,8 +364,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="508"
-                                    class="link-to-prism">src/lib/config.service.ts:508</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="551"
+                                    class="link-to-prism">src/lib/config.service.ts:551</a></div>
                         </td>
                     </tr>
 
@@ -441,8 +441,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="509"
-                                    class="link-to-prism">src/lib/config.service.ts:509</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="552"
+                                    class="link-to-prism">src/lib/config.service.ts:552</a></div>
                         </td>
                     </tr>
 
@@ -530,8 +530,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="510"
-                                    class="link-to-prism">src/lib/config.service.ts:510</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="553"
+                                    class="link-to-prism">src/lib/config.service.ts:553</a></div>
                         </td>
                     </tr>
 
@@ -619,8 +619,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="485"
+                                    class="link-to-prism">src/lib/config.service.ts:485</a></div>
                         </td>
                     </tr>
 
@@ -721,8 +721,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="448"
-                                    class="link-to-prism">src/lib/config.service.ts:448</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="491"
+                                    class="link-to-prism">src/lib/config.service.ts:491</a></div>
                         </td>
                     </tr>
 
@@ -831,8 +831,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="514"
-                                    class="link-to-prism">src/lib/config.service.ts:514</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="557"
+                                    class="link-to-prism">src/lib/config.service.ts:557</a></div>
                         </td>
                     </tr>
 
@@ -908,8 +908,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="515"
-                                    class="link-to-prism">src/lib/config.service.ts:515</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="558"
+                                    class="link-to-prism">src/lib/config.service.ts:558</a></div>
                         </td>
                     </tr>
 
@@ -997,8 +997,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="516"
-                                    class="link-to-prism">src/lib/config.service.ts:516</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="559"
+                                    class="link-to-prism">src/lib/config.service.ts:559</a></div>
                         </td>
                     </tr>
 
@@ -1087,8 +1087,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="106"
-                                    class="link-to-prism">src/lib/config.service.ts:106</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="121"
+                                    class="link-to-prism">src/lib/config.service.ts:121</a></div>
                         </td>
                     </tr>
 
@@ -1173,8 +1173,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="500"
-                                    class="link-to-prism">src/lib/config.service.ts:500</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="543"
+                                    class="link-to-prism">src/lib/config.service.ts:543</a></div>
                         </td>
                     </tr>
 
@@ -1243,8 +1243,8 @@
 
                     <tr>
                         <td class="col-md-4">
-                            <div class="io-line">Defined in <a href="" data-line="423"
-                                    class="link-to-prism">src/lib/config.service.ts:423</a></div>
+                            <div class="io-line">Defined in <a href="" data-line="466"
+                                    class="link-to-prism">src/lib/config.service.ts:466</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="86" class="link-to-prism">src/lib/config.service.ts:86</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="101" class="link-to-prism">src/lib/config.service.ts:101</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="65" class="link-to-prism">src/lib/config.service.ts:65</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>
 
@@ -1417,7 +1417,7 @@
                 </tr>
                     <tr>
                         <td class="col-md-4">
-                                <div class="io-line">Defined in <a href="" data-line="72" class="link-to-prism">src/lib/config.service.ts:72</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="87" class="link-to-prism">src/lib/config.service.ts:87</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="80" class="link-to-prism">src/lib/config.service.ts:80</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="95" class="link-to-prism">src/lib/config.service.ts:95</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="59" class="link-to-prism">src/lib/config.service.ts:59</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="74" class="link-to-prism">src/lib/config.service.ts:74</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="62" class="link-to-prism">src/lib/config.service.ts:62</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="77" class="link-to-prism">src/lib/config.service.ts:77</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="60" class="link-to-prism">src/lib/config.service.ts:60</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="75" class="link-to-prism">src/lib/config.service.ts:75</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="63" class="link-to-prism">src/lib/config.service.ts:63</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>
 
@@ -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="78" class="link-to-prism">src/lib/config.service.ts:78</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="93" class="link-to-prism">src/lib/config.service.ts:93</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="85" class="link-to-prism">src/lib/config.service.ts:85</a></div>
+                                <div class="io-line">Defined in <a href="" data-line="100" class="link-to-prism">src/lib/config.service.ts:100</a></div>
                         </td>
                     </tr>
 
@@ -1690,6 +1690,13 @@ export enum ConfigLoadingStrategy {
   FIFO &#x3D; &#x27;fifo&#x27;,
 }
 
+export enum ConfigLoadMethod {
+  FROM_URLS &#x3D; &#x27;fromUrls&#x27;,
+  FROM_LOCAL_STORAGE &#x3D; &#x27;fromLocalStorage&#x27;,
+  FROM_URL_PARAM &#x3D; &#x27;fromUrlParam&#x27;,
+  FROM_CID &#x3D; &#x27;fromCid&#x27;,
+}
+
 export interface ConfigLoadOptions {
   fromUrlParam?: string | boolean;
   fromUrls?: boolean;
@@ -1713,6 +1720,14 @@ export interface ConfigLoadOptions {
   fetchCidContent?: (cid: string, path?: string) &#x3D;&gt; Promise&lt;Blob | null&gt;;
   dnsServers?: string[];
   strategy?: ConfigLoadingStrategy;
+  /**
+   * Defines the order and subset of config sources to load.
+   * If not specified, defaults to: [FROM_URLS, FROM_LOCAL_STORAGE, FROM_URL_PARAM, FROM_CID]
+   *
+   * Note: static config is always merged first, and Overwrites are always merged last.
+   * Note: fromDns is not a source itself - it resolves the CID for FROM_CID.
+   */
+  order?: ConfigLoadMethod[];
 }
 
 @Injectable({
@@ -1785,81 +1800,60 @@ export class ConfigService&lt;Config extends Record&lt;string, any&gt; &#x3D; Re
       }
     }
 
+    // Always merge static config first
     config &#x3D; deepMerge(config, options?.static ?? {});
-    let done &#x3D; false;
 
-    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;);
-        }
-      }
-    }
+    // Determine the order of config sources to load
+    const order &#x3D; options.order ?? [
+      ConfigLoadMethod.FROM_URLS,
+      ConfigLoadMethod.FROM_LOCAL_STORAGE,
+      ConfigLoadMethod.FROM_URL_PARAM,
+      ConfigLoadMethod.FROM_CID,
+    ];
 
-    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;);
-        }
-      }
+    // If fromDns is enabled and FROM_CID is in the order, resolve CID first
+    if (options.fromDns &amp;&amp; order.includes(ConfigLoadMethod.FROM_CID) &amp;&amp; !options.fromCid) {
+      await this.loadConfigFromDns(options as any);
     }
 
-    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;);
-        }
+    // Load configs from sources in the specified order
+    let done &#x3D; false;
+    for (const method of order) {
+      if (done) {
+        break;
       }
-    }
 
-    if (!done &amp;&amp; options?.fromDns) {
-      await this.loadConfigFromDns(options as any);
-    }
+      // Check if the source is enabled
+      if (!this.isSourceEnabled(options, method)) {
+        continue;
+      }
 
-    if (!done &amp;&amp; options?.fromCid) {
       try {
-        config &#x3D; deepMerge(config, await this.loadConfigFromCid(options as any));
+        const loadedConfig &#x3D; await this.loadConfigFromMethod(method, options, environment);
+        if (loadedConfig) {
+          config &#x3D; deepMerge(config, loadedConfig);
+        }
+
+        // If using FIFO strategy, stop after first successful load
         if (options.strategy &#x3D;&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
           done &#x3D; true;
         }
       } catch (error: any) {
+        const methodName &#x3D; this.getMethodName(method);
         if (options.strategy !&#x3D;&#x3D; ConfigLoadingStrategy.FIFO) {
-          console.error(&#x27;Could not load config from cid&#x27;, error);
+          console.error(&#x60;Could not load config from ${methodName}&#x60;, error);
           throw error;
         } else {
-          console.warn(&#x27;Could not load config from cid: &#x27; + error.message + &#x27;. Will try next strategy.&#x27;);
+          console.warn(&#x60;Could not load config from ${methodName}: ${error.message}. Will try next strategy.&#x60;);
         }
       }
     }
 
-    if (!done) {
+    if (!done &amp;&amp; order.length &gt; 0) {
       console.warn(&#x27;No config loading strategy succeeded. Using default config.&#x27;);
     }
 
+    // Always merge overwrites last
     config &#x3D; deepMerge(config, this.Overwrites);
 
     console.debug(&#x27;app config&#x27;, config);
@@ -1867,6 +1861,55 @@ export class ConfigService&lt;Config extends Record&lt;string, any&gt; &#x3D; Re
     this.Config &#x3D; config;
   }
 
+  private static isSourceEnabled(options: ConfigLoadOptions, method: ConfigLoadMethod): boolean {
+    switch (method) {
+      case ConfigLoadMethod.FROM_URLS:
+        return options.fromUrls !&#x3D;&#x3D; false;
+      case ConfigLoadMethod.FROM_LOCAL_STORAGE:
+        return options.fromLocalStorage !&#x3D;&#x3D; false;
+      case ConfigLoadMethod.FROM_URL_PARAM:
+        return !!options.fromUrlParam;
+      case ConfigLoadMethod.FROM_CID:
+        return !!options.fromCid;
+      default:
+        return false;
+    }
+  }
+
+  private static async loadConfigFromMethod(
+    method: ConfigLoadMethod,
+    options: ConfigLoadOptions,
+    environment?: Environment,
+  ): Promise&lt;any&gt; {
+    switch (method) {
+      case ConfigLoadMethod.FROM_URLS:
+        return await this.loadConfigFromUrls(options, environment);
+      case ConfigLoadMethod.FROM_LOCAL_STORAGE:
+        return this.loadConfigFromLocalStorage(options);
+      case ConfigLoadMethod.FROM_URL_PARAM:
+        return this.loadConfigFromUrlParam(options as any);
+      case ConfigLoadMethod.FROM_CID:
+        return await this.loadConfigFromCid(options as any);
+      default:
+        return null;
+    }
+  }
+
+  private static getMethodName(method: ConfigLoadMethod): string {
+    switch (method) {
+      case ConfigLoadMethod.FROM_URLS:
+        return &#x27;urls&#x27;;
+      case ConfigLoadMethod.FROM_LOCAL_STORAGE:
+        return &#x27;local storage&#x27;;
+      case ConfigLoadMethod.FROM_URL_PARAM:
+        return &#x27;url param&#x27;;
+      case ConfigLoadMethod.FROM_CID:
+        return &#x27;cid&#x27;;
+      default:
+        return &#x27;unknown&#x27;;
+    }
+  }
+
   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);